エラーカタログ
すべてのエラーは 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 - 利用権トークン：トークンのオーディエンスまたは発行者がこの 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ヘッダーに、サポートしているメディアタイプが 1 つも含まれていません。本文はそれでもapplication/problem+jsonです。- 409
conflict - リソースが重複しています。たとえば、同じ URL を持つ 2 つ目のウェブフックエンドポイントなどです。
- 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 - 1 つ以上のパラメーターの値が無効です。
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 - 1 日または 1 か月のクォータを使い切りました。
Retry-Afterとquota_resets_atがリセットの時期を示し、upgrade_urlが料金ページへのリンクです。 - 500
internal_error - こちら側で問題が発生しました。バックオフしながらリトライし、解決しない場合はリクエスト ID をお送りください。
- データベースが利用できないかサービスがメンテナンス中、または
Idempotency-Key付きのリクエストが 20 秒を過ぎても実行中だったため、何も変更せずにキャンセルされました。Retry-After秒後にリトライしてください。同じ値はretry_after_secondsにも入っています（キャンセルされたリクエストでは 1。同じキーでリトライしてください）。