콘텐츠로 건너뛰기
Telemetry
문서 찾아보기

API 레퍼런스업데이트된 2026년 9월 30일2 최소 읽기

코딩 에이전트와 함께 이 문서를 사용하세요.

Claude Code, Codex, Cursor 또는 다른 코딩 에이전트에 대한 집중 프롬프트 팩을 연 다음 여기에서 다루는 워크플로에 맞게 조정하세요.

이 페이지에서
  1. 성공 응답
  2. 일치하는 행 삭제
  3. 전체 테이블 삭제
  4. cURL의 사용 예
  5. 일반적인 오류

삭제

이 예제는 예약된 샘플 테이블 telemetry_quickstart의 가상 데이터를 사용합니다. API 동작을 확인할 뿐, 애플리케이션 계측이 완료되었다는 뜻은 아닙니다. 실제 애플리케이션에서는 작업 흐름에 맞는 테이블을 선택하고 실제 작업에서 이벤트를 보내세요.

Delete API로 조건에 맞는 행이나 테이블 전체를 삭제하세요. 삭제는 되돌릴 수 없습니다.

삭제 https://api.telemetry.sh/delete

헤더

이름 유형 설명
콘텐츠 유형 문자열 애플리케이션/json
승인 문자열 API 키(원본 키 또는 Bearer <key>)

범위 규칙:

  • DELETE /delete에는 read-and-write가 필요합니다.

본문

이름 유형 설명
테이블 문자열 데이터를 삭제하려는 테이블
어디서 문자열(선택사항) 삭제할 행에 대한 SQL 절

where를 생략하면 Telemetry는 요청을 전체 테이블 삭제로 처리합니다.

성공 응답

삭제 응답은 비동기식 정리 승인입니다. API는 삭제 다시 쓰기 또는 테이블 비활성화 단계가 성공적으로 예약되자마자 200 OK를 반환합니다.

일치하는 행 삭제

{
  "status": "success",
  "message": "Delete rewrite completed; part cleanup is asynchronous"
}

전체 테이블 삭제

{
  "status": "success",
  "message": "Table disabled; part cleanup is asynchronous"
}

cURL의 사용 예

cURL을 사용하여 telemetry_quickstart라는 테이블에서 3일보다 오래된 모든 행을 삭제하려면 다음 명령을 사용할 수 있습니다.

API_KEY="YOUR_API_KEY"
WHERE_CONDITION="timestamp <= (now() - INTERVAL '3 day')"

curl -X DELETE https://api.telemetry.sh/delete \
  -H "Content-Type: application/json" \
  -H "Authorization: $API_KEY" \
  -d @- <<EOF
{
  "table": "telemetry_quickstart",
  "where": "$WHERE_CONDITION"
}
EOF

전체 telemetry_quickstart 테이블을 삭제하려면 where 필드를 생략하면 됩니다.

API_KEY="YOUR_API_KEY"

curl -X DELETE https://api.telemetry.sh/delete \
  -H "Content-Type: application/json" \
  -H "Authorization: $API_KEY" \
  -d '{
    "table": "telemetry_quickstart"
  }'

중요 사항

  • 데이터 삭제: 삭제 엔드포인트를 사용할 때는 주의하세요. where 조건이 제공되지 않으면 테이블 전체가 삭제됩니다.
  • 되돌릴 수 없음: 데이터가 삭제되면 복구할 수 없습니다.
  • 레거시 엔드포인트: 가능하면 전체 테이블 수명 주기 작업에 대해 테이블 ​​API를 선호합니다. DELETE /delete는 where 절을 사용한 행 수준 삭제에 여전히 유용합니다.

일반적인 오류

  • JSON 본문이 유효하지 않은 경우 400 Bad Request
  • 정규화 후 테이블 이름에 잘못된 문자가 포함된 경우 400 Bad Request
  • API 키에 read-and-write 범위가 없는 경우 403 Forbidden
  • API 키가 없거나 잘못된 경우 401 Unauthorized
  • 아직 스키마가 없는 테이블에서 행을 삭제하려고 하는 경우 404 Not Found
  • Telemetry가 삭제 요청을 실행하지 못한 경우 500 Internal Server Error

관련 기능

안정적인 이벤트 이름, 타입이 지정된 필드, 개인 정보 보호 검토 컨텍스트를 캡처합니다.

페이지 작성자 및 참고 자료

이 설명은 Telemetry 편집팀의 소유입니다. 제품 팀은 동작, 예시, 경계를 검토합니다.

문서 검토 방법