Catalogul erorilor

Fiecare eroare este un problem document RFC 9457 al cărui type trimite la o intrare de pe această pagină și al cărui code este numele intrării. instance conține id-ul cererii; menționați-l când contactați suportul.

400 invalid_request

Cererea este formată incorect: un parametru de query necunoscut, un corp care nu poate fi citit, un parametru pe care endpoint-ul nu îl acceptă sau un Idempotency-Key format incorect. Corectați cererea; nu o reîncercați așa cum este.

400 invalid_cursor

Valoarea cursor este formată incorect, este mai veche de 24 de ore sau a fost emisă pentru alte filtre; un since_cursor al feed-ului de potriviri expiră doar după ce depășește perioada de păstrare a potrivirilor, de 30 de zile. Reluați listarea de la prima pagină (un feed fără cursor).

401 unauthenticated

Endpoint-ul necesită o cheie și nu a fost trimisă niciuna. Este setat WWW-Authenticate: Bearer realm="api.tuneping.com".

401 invalid_api_key

Cheia are un format greșit sau nu este cunoscută. Verificați dacă nu este trunchiată și dacă are prefixul tp_live_ / tp_test_.

401 key_revoked

Cheia a fost rotită sau revocată; revoked_at indică momentul. Folosiți cheia curentă.

401 token_invalid

Token-uri de entitlement (aplicații partenere): token-ul este format incorect sau semnătura lui este necunoscută.

401 token_expired

Token-uri de entitlement: token-ul a expirat dincolo de toleranța permisă. Reîmprospătați-l o singură dată.

401 token_audience

Token-uri de entitlement: audience-ul sau emitentul token-ului nu este acest API.

403 forbidden_tier

Endpoint-ul sau valoarea parametrului necesită un plan superior, de exemplu un from pentru istoric mai vechi decât adâncimea planului dumneavoastră sau mai multe id-uri într-un batch decât permite planul. required_tier numește planul, upgrade_url trimite la prețuri.

403 forbidden_scope

Cheia există, dar a fost emisă fără scope-ul de care are nevoie această operațiune (wishlists sau webhooks; un wishlist cu livrare prin webhook necesită și webhooks, verificat înaintea planului); required_scope îl numește, iar WWW-Authenticate conține error="insufficient_scope". Folosiți o cheie care are acest scope; cheile au toate scope-urile, cu excepția celor emise cu o listă mai restrânsă, de exemplu doar pentru citire, iar GET /v1/me listează scope-urile unei chei.

403 entitlement_revoked

Token-ul de entitlement trece verificarea, dar licența lui a fost revocată. Pass-ul a expirat; reîmprospătarea nu ajută.

403 livemode_mismatch

O cheie tp_test_ a fost folosită pentru o operațiune disponibilă doar în modul live, de exemplu un endpoint de webhook în afara host-urilor de test (webhook.site).

404 not_found

Nu există un astfel de post, piesă, artist sau resursă, ori pentru acest post nu a fost observat încă niciun titlu live.

404 station_opted_out

Postul există în director, dar a cerut să nu fie indexat. Tuneping nu spune de ce. Considerați-l indisponibil permanent.

406 not_acceptable

Header-ul Accept nu conține niciunul dintre tipurile media acceptate. Corpul răspunsului este totuși application/problem+json.

409 conflict

Resursă duplicată, de exemplu un al doilea endpoint de webhook cu același URL.

409 idempotency_in_progress

O cerere cu același Idempotency-Key este încă în execuție. Reîncercați după Retry-After secunde pentru a primi răspunsul ei.

410 endpoint_sunset

Endpoint-ul a fost retras după data Sunset anunțată; un header Link trimite la intrarea din changelog.

413 payload_too_large

Corpul cererilor este limitat la 64 KiB; PUT /v1/wishlists acceptă până la 1 MiB.

422 validation_failed

Unul sau mai mulți parametri au valori invalide. errors[] listează pentru fiecare field, code și un message pe înțelesul oamenilor.

422 idempotency_key_reused

Idempotency-Key a fost deja folosit în ultimele 24 de ore pentru o altă cerere (metodă, cale, query sau corp). Trimiteți o cheie nouă pentru o cerere nouă.

429 rate_limited

Token bucket-ul pe secundă este gol. Așteptați Retry-After secunde; header-ul RateLimit numește politica epuizată.

429 too_many_connections

Cheia are deja atâtea stream-uri de evenimente deschise câte permite planul ei (Developer 1, Pro 5, Business 20, Tapelark 1 per dispozitiv). Închideți mai întâi unul.

429 quota_exceeded

Cota zilnică sau lunară este consumată. Retry-After și quota_resets_at indică momentul resetării; upgrade_url trimite la prețuri.

500 internal_error

Ceva a eșuat la noi. Reîncercați cu backoff și trimiteți-ne id-ul cererii dacă problema persistă.

503 unavailable

Baza de date nu este disponibilă sau serviciul este în mentenanță, ori o cerere cu un Idempotency-Key încă rula după 20 de secunde și a fost anulată fără să se fi modificat nimic. Reîncercați după Retry-After secunde, valoare dată și ca retry_after_seconds (1 pentru cererea anulată; reîncercați-o cu aceeași cheie).

Înapoi la referința API