Catalogo degli errori

Ogni errore è un problem document RFC 9457 il cui type punta a una voce di questa pagina e il cui code è il nome della voce. instance contiene l'id della richiesta; indicalo al supporto.

400 invalid_request: La richiesta è malformata: un parametro di query sconosciuto, un body illeggibile, un parametro che l'endpoint non accetta o un Idempotency-Key malformato. Correggi la richiesta; non ripeterla così com'è.
400 invalid_cursor: Il cursor è malformato, ha più di 24 ore o è stato emesso per filtri diversi; un since_cursor del feed dei match scade solo quando supera i 30 giorni di conservazione dei match. Ricomincia l'elenco dalla prima pagina (un feed senza cursore).
401 unauthenticated: L'endpoint richiede una chiave e non ne è stata inviata nessuna. È impostato WWW-Authenticate: Bearer realm="api.tuneping.com".
401 invalid_api_key: La chiave ha un formato errato o non è conosciuta. Controlla che non sia troncata e il prefisso tp_live_ / tp_test_.
401 key_revoked: La chiave è stata ruotata o revocata; revoked_at dice quando. Usa la chiave attuale.
401 token_invalid: Entitlement token (app partner): il token è malformato o la sua firma è sconosciuta.
401 token_expired: Entitlement token: il token è scaduto oltre la tolleranza consentita. Rinnovalo una volta.
401 token_audience: Entitlement token: l'audience o l'emittente del token non è questa API.
403 forbidden_tier: L'endpoint o il valore del parametro richiede un piano superiore, per esempio un from dello storico più vecchio della profondità del tuo piano o più id in batch di quanti il piano ne consenta. required_tier indica il piano, upgrade_url rimanda ai prezzi.
403 forbidden_scope: La chiave esiste ma è stata emessa senza lo scope richiesto da questa operazione (wishlists o webhooks; una wishlist con consegna webhook richiede anche webhooks, verificato prima del piano); required_scope lo indica e WWW-Authenticate contiene error="insufficient_scope". Usa una chiave con quello scope; le chiavi hanno tutti gli scope a meno che non siano state emesse con un elenco più ristretto, per esempio di sola lettura, e GET /v1/me elenca gli scope di una chiave.
403 entitlement_revoked: L'entitlement token è verificato ma la sua licenza è stata revocata. Il pass è scaduto; rinnovarlo non serve.
403 livemode_mismatch: È stata usata una chiave tp_test_ per un'operazione solo live, per esempio un endpoint webhook al di fuori degli host di test (webhook.site).
404 not_found: Stazione, brano, artista o risorsa inesistente, oppure per la stazione non è ancora stato osservato alcun titolo in onda.
404 station_opted_out: La stazione esiste nell'elenco ma ha chiesto di non essere indicizzata. Tuneping non dice perché. Considerala non disponibile in modo permanente.
406 not_acceptable: L'header Accept non elenca nessuno dei media type supportati. Il body resta comunque application/problem+json.
409 conflict: Risorsa duplicata, per esempio un secondo endpoint webhook con lo stesso URL.
409 idempotency_in_progress: Una richiesta con lo stesso Idempotency-Key è ancora in esecuzione. Riprova dopo Retry-After secondi per ricevere la sua risposta.
410 endpoint_sunset: L'endpoint è stato ritirato dopo la data Sunset annunciata; un header Link punta alla voce del changelog.
413 payload_too_large: I body delle richieste sono limitati a 64 KiB; PUT /v1/wishlists accetta fino a 1 MiB.
422 validation_failed: Uno o più parametri hanno valori non validi. errors[] elenca field, code e un message leggibile per ciascuno.
422 idempotency_key_reused: L'Idempotency-Key è già stato usato nelle ultime 24 ore per una richiesta diversa (metodo, percorso, query o body). Invia una nuova chiave per una nuova richiesta.
429 rate_limited: Il token bucket al secondo è vuoto. Attendi Retry-After secondi; l'header RateLimit indica la policy esaurita.
429 too_many_connections: La chiave ha già tanti stream di eventi aperti quanti ne consente il suo piano (Developer 1, Pro 5, Business 20, Tapelark 1 per dispositivo). Chiudine prima uno.
429 quota_exceeded: La quota giornaliera o mensile è esaurita. Retry-After e quota_resets_at dicono quando si azzera; upgrade_url rimanda ai prezzi.
500 internal_error: Qualcosa non ha funzionato da parte nostra. Riprova con backoff e inviaci l'id della richiesta se il problema persiste.
503 unavailable: Il database non è disponibile o il servizio è in manutenzione, oppure una richiesta con un Idempotency-Key era ancora in esecuzione dopo 20 secondi ed è stata annullata senza modificare nulla. Riprova dopo Retry-After secondi, indicati anche in retry_after_seconds (1 per la richiesta annullata; ripetila con la stessa chiave).

Torna alla guida di riferimento dell'API