Katalog error

Setiap error adalah dokumen problem RFC 9457 yang type-nya menunjuk ke sebuah entri di halaman ini dan yang code-nya adalah nama entri tersebut. instance membawa id permintaan; sertakan id itu saat menghubungi dukungan.

400 invalid_request

Permintaan salah format: parameter query yang tidak dikenal, body yang tidak dapat dibaca, parameter yang tidak diterima endpoint, atau Idempotency-Key yang salah format. Perbaiki permintaannya; jangan mengulanginya apa adanya.

400 invalid_cursor

cursor salah format, berumur lebih dari 24 jam, atau diterbitkan untuk filter yang berbeda; since_cursor dari feed kecocokan baru kedaluwarsa setelah berumur lebih dari masa retensi kecocokan 30 hari. Mulai ulang daftar dari halaman pertama (untuk feed: tanpa cursor).

401 unauthenticated

Endpoint memerlukan key dan tidak ada yang dikirim. WWW-Authenticate: Bearer realm="api.tuneping.com" disetel.

401 invalid_api_key

Key memiliki bentuk yang salah atau tidak dikenal. Periksa apakah key terpotong dan periksa prefiks tp_live_ / tp_test_.

401 key_revoked

Key telah dirotasi atau dicabut; revoked_at menyebutkan kapan. Gunakan key yang berlaku saat ini.

401 token_invalid

Entitlement token (aplikasi partner): token salah format atau tanda tangannya tidak dikenal.

401 token_expired

Entitlement token: token kedaluwarsa melebihi toleransi selisih waktu yang diizinkan. Perbarui token sekali.

401 token_audience

Entitlement token: audience atau issuer token bukan API ini.

403 forbidden_tier

Endpoint atau nilai parameter memerlukan paket yang lebih tinggi, misalnya from riwayat yang lebih lama dari kedalaman paket Anda atau id batch lebih banyak daripada yang diizinkan paket. required_tier menyebutkan paketnya, upgrade_url menautkan ke harga.

403 forbidden_scope

Key ada tetapi diterbitkan tanpa scope yang diperlukan operasi ini (wishlists atau webhooks; wishlist dengan pengiriman webhook juga memerlukan webhooks, diperiksa sebelum paket); required_scope menyebutkannya dan WWW-Authenticate membawa error="insufficient_scope". Gunakan key yang memiliki scope tersebut; key membawa semua scope kecuali diterbitkan dengan daftar yang lebih sempit, misalnya hanya-baca, dan GET /v1/me mencantumkan scope sebuah key.

403 entitlement_revoked

Entitlement token lolos verifikasi tetapi lisensinya telah dicabut. Pass-nya telah berakhir; memperbarui token tidak akan membantu.

403 livemode_mismatch

Key tp_test_ digunakan untuk operasi yang hanya untuk mode live, misalnya endpoint webhook di luar host pengujian (webhook.site).

404 not_found

Tidak ada stasiun, lagu, artis, atau resource tersebut, atau belum ada judul langsung yang teramati untuk stasiun itu.

404 station_opted_out

Stasiun ada di direktori tetapi meminta untuk tidak diindeks. Tuneping tidak menyebutkan alasannya. Anggap stasiun itu tidak tersedia secara permanen.

406 not_acceptable

Header Accept tidak mencantumkan satu pun media type yang didukung. Body-nya tetap application/problem+json.

409 conflict

Resource duplikat, misalnya endpoint webhook kedua dengan URL yang sama.

409 idempotency_in_progress

Permintaan dengan Idempotency-Key yang sama masih berjalan. Ulangi setelah Retry-After detik untuk menerima responsnya.

410 endpoint_sunset

Endpoint telah dihentikan setelah tanggal Sunset yang diumumkan; header Link menunjuk ke entri changelog.

413 payload_too_large

Body permintaan dibatasi 64 KiB; PUT /v1/wishlists menerima hingga 1 MiB.

422 validation_failed

Satu atau beberapa parameter memiliki nilai yang tidak valid. errors[] mencantumkan field, code, dan message yang dapat dibaca manusia untuk masing-masing.

422 idempotency_key_reused

Idempotency-Key sudah digunakan dalam 24 jam terakhir untuk permintaan yang berbeda (metode, path, query, atau body). Kirim key baru untuk permintaan baru.

429 rate_limited

Token bucket per detik kosong. Tunggu Retry-After detik; header RateLimit menyebutkan kebijakan yang habis.

429 too_many_connections

Key sudah memiliki event stream terbuka sebanyak yang diizinkan paketnya (Developer 1, Pro 5, Business 20, Tapelark 1 per perangkat). Tutup salah satunya terlebih dahulu.

429 quota_exceeded

Kuota harian atau bulanan telah habis. Retry-After dan quota_resets_at menyebutkan kapan kuota direset; upgrade_url menautkan ke harga.

500 internal_error

Terjadi kegagalan di pihak kami. Ulangi dengan backoff dan kirimkan id permintaan kepada kami jika masalah berlanjut.

503 unavailable

Database tidak tersedia atau layanan sedang dalam pemeliharaan, atau permintaan dengan Idempotency-Key masih berjalan setelah 20 detik dan dibatalkan tanpa ada yang berubah. Ulangi setelah Retry-After detik, yang juga diberikan sebagai retry_after_seconds (1 untuk permintaan yang dibatalkan; ulangi dengan key yang sama).

Kembali ke referensi API