오류 카탈로그

모든 오류는 RFC 9457 problem 문서이며, type은 이 페이지의 항목을 가리키고 code는 그 항목의 이름입니다. instance에는 요청 id가 담겨 있으니 지원팀에 문의할 때 함께 알려 주세요.

400 invalid_request

요청 형식이 잘못되었습니다. 알 수 없는 쿼리 파라미터, 읽을 수 없는 본문, 엔드포인트가 받지 않는 파라미터, 또는 형식이 잘못된 Idempotency-Key입니다. 요청을 수정하세요. 그대로 재시도하지 마세요.

400 invalid_cursor

cursor의 형식이 잘못되었거나, 24시간보다 오래되었거나, 다른 필터로 발급되었습니다. 매치 피드의 since_cursor는 30일 매치 보관 기간보다 오래된 경우에만 만료됩니다. 첫 페이지(커서 없는 피드)부터 다시 조회하세요.

401 unauthenticated

키가 필요한 엔드포인트인데 키를 보내지 않았습니다. WWW-Authenticate: Bearer realm="api.tuneping.com"이 설정됩니다.

401 invalid_api_key

키의 형식이 잘못되었거나 알 수 없는 키입니다. 키가 잘리지 않았는지, tp_live_ / tp_test_ 접두사가 맞는지 확인하세요.

401 key_revoked

키가 교체되었거나 폐기되었습니다. revoked_at에 시각이 나옵니다. 현재 키를 사용하세요.

401 token_invalid

이용 권한 토큰(파트너 앱): 토큰 형식이 잘못되었거나 서명을 알 수 없습니다.

401 token_expired

이용 권한 토큰: 허용된 시간 오차를 넘어 토큰이 만료되었습니다. 한 번 갱신하세요.

401 token_audience

이용 권한 토큰: 토큰의 대상(audience) 또는 발급자가 이 API가 아닙니다.

403 forbidden_tier

엔드포인트나 파라미터 값에 더 높은 플랜이 필요합니다. 예를 들어 플랜의 보관 기간보다 오래된 기록 from이나, 플랜이 허용하는 것보다 많은 일괄 조회 id입니다. required_tier는 필요한 플랜을, upgrade_url은 요금 페이지를 가리킵니다.

403 forbidden_scope

키는 존재하지만 이 작업에 필요한 스코프(wishlists 또는 webhooks. webhook 전달을 쓰는 위시리스트는 webhooks도 필요하며, 플랜보다 먼저 확인됨) 없이 발급되었습니다. required_scope가 필요한 스코프를 알려 주고, WWW-Authenticate에는 error="insufficient_scope"가 담깁니다. 해당 스코프가 있는 키를 사용하세요. 읽기 전용 등 더 좁은 목록으로 발급되지 않은 한 키는 모든 스코프를 가지며, GET /v1/me에서 키의 스코프를 확인할 수 있습니다.

403 entitlement_revoked

이용 권한 토큰은 검증되지만 해당 라이선스가 폐기되었습니다. 이용권이 만료되었으므로 갱신해도 소용없습니다.

403 livemode_mismatch

라이브 전용 작업에 tp_test_ 키를 사용했습니다. 예를 들어 테스트 호스트(webhook.site) 이외의 웹훅 엔드포인트입니다.

404 not_found

해당 방송국, 트랙, 아티스트 또는 리소스가 없거나, 그 방송국의 실시간 제목이 아직 확인되지 않았습니다.

404 station_opted_out

방송국이 디렉터리에는 있지만 인덱싱하지 말 것을 요청했습니다. Tuneping은 그 이유를 밝히지 않습니다. 영구적으로 이용할 수 없는 것으로 취급하세요.

406 not_acceptable

Accept 헤더에 지원되는 미디어 타입이 하나도 없습니다. 본문은 그래도 application/problem+json입니다.

409 conflict

중복된 리소스입니다. 예를 들어 URL이 같은 두 번째 웹훅 엔드포인트입니다.

409 idempotency_in_progress

같은 Idempotency-Key를 가진 요청이 아직 실행 중입니다. Retry-After초 후에 재시도하면 그 요청의 응답을 받습니다.

410 endpoint_sunset

공지된 Sunset 날짜 이후 엔드포인트가 종료되었습니다. Link 헤더가 변경 기록 항목을 가리킵니다.

413 payload_too_large

요청 본문은 64 KiB로 제한됩니다. PUT /v1/wishlists는 최대 1 MiB까지 받습니다.

422 validation_failed

하나 이상의 파라미터 값이 유효하지 않습니다. errors[]에 각 항목의 field, code, 사람이 읽을 수 있는 message가 나열됩니다.

422 idempotency_key_reused

이 Idempotency-Key는 최근 24시간 이내에 다른 요청(메서드, 경로, 쿼리 또는 본문)에 이미 사용되었습니다. 새 요청에는 새 키를 보내세요.

429 rate_limited

초당 토큰 버킷이 비었습니다. Retry-After초 동안 기다리세요. RateLimit 헤더에 소진된 정책이 나옵니다.

429 too_many_connections

키가 플랜이 허용하는 만큼의 이벤트 스트림을 이미 열어 두고 있습니다(Developer 1개, Pro 5개, Business 20개, Tapelark 기기당 1개). 먼저 하나를 닫으세요.

429 quota_exceeded

일일 또는 월간 할당량을 모두 사용했습니다. Retry-After와 quota_resets_at에 초기화 시점이 나오며, upgrade_url은 요금 페이지를 가리킵니다.

500 internal_error

저희 쪽에서 문제가 발생했습니다. 백오프를 두고 재시도하고, 문제가 계속되면 요청 id를 보내 주세요.

503 unavailable

데이터베이스를 사용할 수 없거나 서비스가 점검 중이거나, Idempotency-Key가 있는 요청이 20초 후에도 실행 중이어서 아무것도 변경하지 않고 취소되었습니다. Retry-After초 후에 재시도하세요. 이 값은 retry_after_seconds로도 제공됩니다(취소된 요청의 경우 1이며, 같은 키로 재시도하세요).

API 레퍼런스로 돌아가기