Hata kataloğu

Her hata, type alanı bu sayfadaki bir girdiyi gösteren ve code alanı o girdinin adı olan bir RFC 9457 problem belgesidir. instance istek kimliğini taşır; destekle yazışırken bunu belirtin.

400 invalid_request

İstek hatalı biçimlendirilmiş: bilinmeyen bir sorgu parametresi, okunamayan bir gövde, uç noktanın kabul etmediği bir parametre veya hatalı biçimlendirilmiş bir Idempotency-Key. İsteği düzeltin; olduğu gibi yeniden denemeyin.

400 invalid_cursor

cursor hatalı biçimlendirilmiş, 24 saatten eski veya farklı filtreler için verilmiş; eşleşme akışının since_cursor değerinin süresi ise ancak 30 günlük eşleşme saklama süresinden eski olduğunda dolar. Listelemeye ilk sayfadan (akışta imleç olmadan) yeniden başlayın.

401 unauthenticated

Uç nokta bir anahtar gerektiriyor ve hiçbiri gönderilmedi. WWW-Authenticate: Bearer realm="api.tuneping.com" ayarlanır.

401 invalid_api_key

Anahtarın biçimi yanlış veya anahtar bilinmiyor. Kesilmiş olup olmadığını ve tp_live_ / tp_test_ önekini kontrol edin.

401 key_revoked

Anahtar yenilendi veya iptal edildi; ne zaman olduğunu revoked_at belirtir. Güncel anahtarı kullanın.

401 token_invalid

Kullanım hakkı token'ları (iş ortağı uygulamaları): token hatalı biçimlendirilmiş veya imzası bilinmiyor.

401 token_expired

Kullanım hakkı token'ları: token'ın süresi, izin verilen saat kaymasının ötesinde dolmuş. Bir kez yenileyin.

401 token_audience

Kullanım hakkı token'ları: token'ın hedef kitlesi (audience) veya yayıncısı (issuer) bu API değil.

403 forbidden_tier

Uç nokta veya parametre değeri daha yüksek bir plan gerektiriyor; örneğin planınızın geçmiş derinliğinden eski bir geçmiş from değeri veya planın izin verdiğinden fazla toplu kimlik. required_tier planı belirtir, upgrade_url fiyatlandırmaya bağlantı verir.

403 forbidden_scope

Anahtar mevcut ancak bu işlemin gerektirdiği kapsam olmadan verilmiş (wishlists veya webhooks; webhook teslimatlı bir istek listesi de webhooks gerektirir ve bu, plandan önce kontrol edilir); required_scope kapsamı belirtir ve WWW-Authenticate, error="insufficient_scope" taşır. Bu kapsama sahip bir anahtar kullanın; anahtarlar, daha dar bir listeyle (örneğin salt okunur) verilmedikçe tüm kapsamları taşır ve GET /v1/me bir anahtarın kapsamlarını listeler.

403 entitlement_revoked

Kullanım hakkı token'ı doğrulanıyor ancak lisansı iptal edilmiş. Erişim hakkının süresi dolmuştur; yenilemek işe yaramaz.

403 livemode_mismatch

Yalnızca canlı modda yapılabilen bir işlem için tp_test_ anahtarı kullanıldı; örneğin test sunucuları (webhook.site) dışındaki bir webhook uç noktası.

404 not_found

Böyle bir istasyon, parça, sanatçı veya kaynak yok ya da istasyon için henüz canlı bir başlık görülmedi.

404 station_opted_out

İstasyon dizinde var ancak dizine eklenmemeyi istedi. Tuneping nedenini söylemez. Kalıcı olarak kullanılamaz kabul edin.

406 not_acceptable

Accept başlığı desteklenen medya türlerinden hiçbirini içermiyor. Gövde yine de application/problem+json olur.

409 conflict

Yinelenen kaynak; örneğin aynı URL'ye sahip ikinci bir webhook uç noktası.

409 idempotency_in_progress

Aynı Idempotency-Key ile yapılan bir istek hâlâ çalışıyor. Yanıtını almak için Retry-After saniye sonra yeniden deneyin.

410 endpoint_sunset

Uç nokta, duyurulan Sunset tarihinden sonra kullanımdan kaldırıldı; bir Link başlığı değişiklik günlüğündeki ilgili girdiyi gösterir.

413 payload_too_large

İstek gövdeleri 64 KiB ile sınırlıdır; PUT /v1/wishlists 1 MiB'a kadar kabul eder.

422 validation_failed

Bir veya daha fazla parametrenin değeri geçersiz. errors[] her biri için field, code ve insanlar için bir message listeler.

422 idempotency_key_reused

Idempotency-Key son 24 saat içinde farklı bir istek (yöntem, yol, sorgu veya gövde) için zaten kullanılmış. Yeni bir istek için yeni bir anahtar gönderin.

429 rate_limited

Saniye başına token kovası boş. Retry-After saniye bekleyin; RateLimit başlığı tükenen politikayı belirtir.

429 too_many_connections

Anahtarın, planının izin verdiği sayıda açık olay akışı zaten var (Developer 1, Pro 5, Business 20, Tapelark cihaz başına 1). Önce birini kapatın.

429 quota_exceeded

Günlük veya aylık kota tükendi. Ne zaman sıfırlanacağını Retry-After ve quota_resets_at belirtir; upgrade_url fiyatlandırmaya bağlantı verir.

500 internal_error

Bizim tarafımızda bir şey başarısız oldu. Artan beklemelerle yeniden deneyin ve sorun sürerse bize istek kimliğini gönderin.

503 unavailable

Veritabanı kullanılamıyor veya hizmet bakımda ya da Idempotency-Key taşıyan bir istek 20 saniye sonra hâlâ çalışıyordu ve hiçbir şey değiştirilmeden iptal edildi. retry_after_seconds olarak da verilen Retry-After saniye sonra yeniden deneyin (iptal edilen istek için 1; aynı anahtarla yeniden deneyin).

API başvurusuna dön