Fehlerkatalog

Jeder Fehler ist ein Problem-Dokument nach RFC 9457, dessen type auf einen Eintrag dieser Seite verweist und dessen code der Name des Eintrags ist. instance enthält die Request-ID; nennen Sie sie dem Support.

400 invalid_request: Die Anfrage ist fehlerhaft: ein unbekannter Query-Parameter, ein unlesbarer Body, ein Parameter, den der Endpoint nicht annimmt, oder ein fehlerhafter Idempotency-Key. Korrigieren Sie die Anfrage; wiederholen Sie sie nicht unverändert.
400 invalid_cursor: Der cursor ist fehlerhaft, älter als 24 Stunden oder wurde für andere Filter ausgegeben; ein since_cursor des Treffer-Feeds läuft erst ab, wenn er älter ist als die Aufbewahrungsdauer der Treffer von 30 Tagen. Beginnen Sie die Auflistung neu ab der ersten Seite (beim Feed: ohne Cursor).
401 unauthenticated: Der Endpoint benötigt einen Schlüssel, und es wurde keiner gesendet. WWW-Authenticate: Bearer realm="api.tuneping.com" ist gesetzt.
401 invalid_api_key: Der Schlüssel hat das falsche Format oder ist unbekannt. Prüfen Sie, ob er abgeschnitten wurde, und das Präfix tp_live_ / tp_test_.
401 key_revoked: Der Schlüssel wurde rotiert oder widerrufen; revoked_at sagt, wann. Verwenden Sie den aktuellen Schlüssel.
401 token_invalid: Entitlement-Tokens (Partner-Apps): Das Token ist fehlerhaft oder seine Signatur unbekannt.
401 token_expired: Entitlement-Tokens: Das Token ist über die erlaubte Zeitabweichung hinaus abgelaufen. Erneuern Sie es einmal.
401 token_audience: Entitlement-Tokens: Audience oder Aussteller des Tokens ist nicht diese API.
403 forbidden_tier: Der Endpoint oder der Parameterwert erfordert einen höheren Tarif, zum Beispiel ein from im Verlauf, das weiter zurückliegt, als Ihr Tarif reicht, oder mehr Batch-IDs, als der Tarif erlaubt. required_tier nennt den Tarif, upgrade_url verlinkt auf die Preise.
403 forbidden_scope: Der Schlüssel existiert, wurde aber ohne den Scope ausgestellt, den dieser Vorgang benötigt (wishlists oder webhooks; eine Wunschliste mit Zustellung per webhook braucht zusätzlich webhooks, geprüft vor dem Tarif); required_scope nennt ihn, und WWW-Authenticate enthält error="insufficient_scope". Verwenden Sie einen Schlüssel mit diesem Scope; Schlüssel haben alle Scopes, sofern sie nicht mit einer engeren Liste ausgestellt wurden, zum Beispiel nur lesend, und GET /v1/me listet die Scopes eines Schlüssels auf.
403 entitlement_revoked: Das Entitlement-Token lässt sich verifizieren, aber seine Lizenz wurde widerrufen. Der Pass ist abgelaufen; Erneuern hilft nicht.
403 livemode_mismatch: Ein tp_test_-Schlüssel wurde für einen Vorgang verwendet, der nur im Live-Modus möglich ist, zum Beispiel einen Webhook-Endpoint außerhalb der Test-Hosts (webhook.site).
404 not_found: Kein solcher Sender, Track, Interpret oder keine solche Ressource, oder für den Sender wurde noch kein Live-Titel beobachtet.
404 station_opted_out: Der Sender steht im Verzeichnis, hat aber gebeten, nicht indexiert zu werden. Tuneping nennt keine Gründe. Behandeln Sie ihn als dauerhaft nicht verfügbar.
406 not_acceptable: Der Accept-Header nennt keinen der unterstützten Medientypen. Der Body ist trotzdem application/problem+json.
409 conflict: Doppelte Ressource, zum Beispiel ein zweiter Webhook-Endpoint mit derselben URL.
409 idempotency_in_progress: Eine Anfrage mit demselben Idempotency-Key läuft noch. Wiederholen Sie sie nach Retry-After Sekunden, um deren Antwort zu erhalten.
410 endpoint_sunset: Der Endpoint wurde nach dem angekündigten Sunset-Datum stillgelegt; ein Link-Header verweist auf den Eintrag im Änderungsprotokoll.
413 payload_too_large: Request-Bodys sind auf 64 KiB begrenzt; PUT /v1/wishlists nimmt bis zu 1 MiB an.
422 validation_failed: Ein oder mehrere Parameter haben ungültige Werte. errors[] nennt für jeden field, code und eine lesbare message.
422 idempotency_key_reused: Der Idempotency-Key wurde in den letzten 24 Stunden bereits für eine andere Anfrage (Methode, Pfad, Query oder Body) verwendet. Senden Sie für eine neue Anfrage einen neuen Idempotency-Key.
429 rate_limited: Der Token-Bucket pro Sekunde ist leer. Warten Sie Retry-After Sekunden; der RateLimit-Header nennt die ausgeschöpfte Policy.
429 too_many_connections: Der Schlüssel hat bereits so viele offene Event-Streams, wie sein Tarif erlaubt (Developer 1, Pro 5, Business 20, Tapelark 1 pro Gerät). Schließen Sie zuerst einen.
429 quota_exceeded: Das Tages- oder Monatskontingent ist aufgebraucht. Retry-After und quota_resets_at sagen, wann es zurückgesetzt wird; upgrade_url verlinkt auf die Preise.
500 internal_error: Auf unserer Seite ist etwas fehlgeschlagen. Wiederholen Sie die Anfrage mit Backoff und senden Sie uns die Request-ID, wenn der Fehler bestehen bleibt.
503 unavailable: Die Datenbank ist nicht verfügbar oder der Dienst in Wartung, oder eine Anfrage mit Idempotency-Key lief nach 20 Sekunden noch und wurde abgebrochen, ohne dass etwas geändert wurde. Wiederholen Sie sie nach Retry-After Sekunden, auch als retry_after_seconds angegeben (1 für die abgebrochene Anfrage; wiederholen Sie sie mit demselben Idempotency-Key).

Zurück zur API-Referenz