Katalog błędów

Każdy błąd to dokument problemu zgodny z RFC 9457, którego type wskazuje wpis na tej stronie, a code jest nazwą tego wpisu. instance zawiera identyfikator żądania; podawaj go w kontakcie ze wsparciem.

400 invalid_request

Żądanie jest niepoprawne: nieznany parametr zapytania, nieczytelna treść, parametr, którego endpoint nie przyjmuje, albo niepoprawny Idempotency-Key. Popraw żądanie; nie ponawiaj go bez zmian.

400 invalid_cursor

cursor jest niepoprawny, starszy niż 24 godziny albo został wydany dla innych filtrów; since_cursor kanału dopasowań wygasa dopiero, gdy jest starszy niż 30-dniowy okres przechowywania dopasowań. Zacznij listowanie od pierwszej strony (kanał bez kursora).

401 unauthenticated

Endpoint wymaga klucza, a nie wysłano żadnego. Ustawiony jest WWW-Authenticate: Bearer realm="api.tuneping.com".

401 invalid_api_key

Klucz ma niewłaściwy format albo jest nieznany. Sprawdź, czy nie został obcięty, i prefiks tp_live_ / tp_test_.

401 key_revoked

Klucz został wymieniony lub unieważniony; revoked_at podaje kiedy. Użyj aktualnego klucza.

401 token_invalid

Tokeny uprawnień (aplikacje partnerskie): token jest niepoprawny albo jego podpis jest nieznany.

401 token_expired

Tokeny uprawnień: token wygasł ponad dopuszczalną tolerancję czasu. Odśwież go jeden raz.

401 token_audience

Tokeny uprawnień: odbiorca (audience) lub wystawca tokenu to nie to API.

403 forbidden_tier

Endpoint lub wartość parametru wymaga wyższego planu, na przykład from historii starszy niż głębokość Twojego planu albo więcej id w żądaniu zbiorczym, niż plan pozwala. required_tier podaje plan, upgrade_url prowadzi do cennika.

403 forbidden_scope

Klucz istnieje, ale został wydany bez zakresu, którego wymaga ta operacja (wishlists lub webhooks; lista życzeń z dostarczaniem webhook wymaga też webhooks, sprawdzanego przed planem); required_scope podaje ten zakres, a WWW-Authenticate zawiera error="insufficient_scope". Użyj klucza z tym zakresem; klucze mają wszystkie zakresy, chyba że wydano je z węższą listą, na przykład tylko do odczytu, a GET /v1/me podaje zakresy klucza.

403 entitlement_revoked

Token uprawnień przechodzi weryfikację, ale jego licencja została unieważniona. Dostęp wygasł; odświeżenie nie pomoże.

403 livemode_mismatch

Klucz tp_test_ został użyty do operacji dostępnej tylko w trybie produkcyjnym, na przykład endpointu webhooka poza hostami testowymi (webhook.site).

404 not_found

Nie ma takiej stacji, utworu, wykonawcy ani zasobu albo dla stacji nie zaobserwowano jeszcze żadnego tytułu na żywo.

404 station_opted_out

Stacja jest w katalogu, ale poprosiła, by jej nie indeksować. Tuneping nie podaje powodu. Traktuj ją jako trwale niedostępną.

406 not_acceptable

Nagłówek Accept nie wymienia żadnego z obsługiwanych typów mediów. Treść odpowiedzi to mimo to application/problem+json.

409 conflict

Zduplikowany zasób, na przykład drugi endpoint webhooka z tym samym URL.

409 idempotency_in_progress

Żądanie z tym samym Idempotency-Key wciąż trwa. Ponów po Retry-After sekundach, by otrzymać jego odpowiedź.

410 endpoint_sunset

Endpoint został wycofany po zapowiedzianej dacie Sunset; nagłówek Link wskazuje wpis w historii zmian.

413 payload_too_large

Treść żądania jest ograniczona do 64 KiB; PUT /v1/wishlists przyjmuje do 1 MiB.

422 validation_failed

Co najmniej jeden parametr ma niepoprawną wartość. errors[] podaje dla każdego field, code i czytelny dla człowieka message.

422 idempotency_key_reused

Idempotency-Key został już użyty w ciągu ostatnich 24 godzin dla innego żądania (metoda, ścieżka, zapytanie lub treść). Dla nowego żądania wyślij nowy klucz.

429 rate_limited

Sekundowy kubełek tokenów jest pusty. Odczekaj Retry-After sekund; nagłówek RateLimit podaje wyczerpaną politykę.

429 too_many_connections

Klucz ma już tyle otwartych strumieni zdarzeń, ile pozwala plan (Developer 1, Pro 5, Business 20, Tapelark 1 na urządzenie). Najpierw zamknij jeden.

429 quota_exceeded

Dzienny lub miesięczny przydział został wykorzystany. Retry-After i quota_resets_at podają, kiedy się odnowi; upgrade_url prowadzi do cennika.

500 internal_error

Coś zawiodło po naszej stronie. Ponawiaj z narastającym odstępem, a jeśli błąd się utrzymuje, wyślij nam identyfikator żądania.

503 unavailable

Baza danych jest niedostępna albo trwa konserwacja usługi, albo żądanie z Idempotency-Key wciąż trwało po 20 sekundach i zostało anulowane bez żadnych zmian. Ponów po Retry-After sekundach, podanych też jako retry_after_seconds (1 dla anulowanego żądania; ponów je z tym samym kluczem).

Powrót do dokumentacji API