tuneping Obtenir une clé

Catalogue des erreurs

Chaque erreur est un document de problème RFC 9457 dont le champ type pointe vers une entrée de cette page et dont le champ code est le nom de cette entrée. instance contient l’identifiant de la requête ; indiquez-le au support.

400 invalid_request
La requête est mal formée : un paramètre de requête inconnu, un corps illisible, un paramètre que l’endpoint n’accepte pas, ou un Idempotency-Key mal formé. Corrigez la requête ; ne la renvoyez pas telle quelle.
400 invalid_cursor
Le cursor est mal formé, date de plus de 24 heures, ou a été émis pour d’autres filtres ; un since_cursor du flux de correspondances n’expire que lorsqu’il dépasse les 30 jours de conservation des correspondances. Reprenez la liste à la première page (un flux sans curseur).
401 unauthenticated
L’endpoint exige une clé et aucune n’a été envoyée. L’en-tête WWW-Authenticate: Bearer realm="api.tuneping.com" est présent.
401 invalid_api_key
La clé n’a pas le bon format ou est inconnue. Vérifiez qu’elle n’est pas tronquée et qu’elle porte le préfixe tp_live_ / tp_test_.
401 key_revoked
La clé a été renouvelée ou révoquée ; revoked_at indique quand. Utilisez la clé actuelle.
401 token_invalid
Jetons de droits (applications partenaires) : le jeton est mal formé ou sa signature est inconnue.
401 token_expired
Jetons de droits : le jeton a expiré au-delà de la tolérance d’horloge autorisée. Rafraîchissez-le une fois.
401 token_audience
Jetons de droits : l’audience ou l’émetteur du jeton n’est pas cette API.
403 forbidden_tier
L’endpoint ou la valeur du paramètre exige une offre supérieure, par exemple un from d’historique plus ancien que la profondeur de votre offre, ou plus d’identifiants par lot que l’offre n’en autorise. required_tier nomme l’offre, upgrade_url renvoie vers les tarifs.
403 forbidden_scope
La clé existe mais a été émise sans le scope dont cette opération a besoin (wishlists ou webhooks ; une liste de souhaits avec livraison webhook a aussi besoin de webhooks, vérifié avant l’offre) ; required_scope le nomme et WWW-Authenticate contient error="insufficient_scope". Utilisez une clé qui a ce scope ; les clés portent tous les scopes, sauf si elles ont été émises avec une liste plus restreinte, par exemple en lecture seule, et GET /v1/me liste les scopes d’une clé.
403 entitlement_revoked
Le jeton de droits est valide mais sa licence a été révoquée. Le pass a expiré ; le rafraîchir n’y changera rien.
403 livemode_mismatch
Une clé tp_test_ a été utilisée pour une opération réservée au mode live, par exemple un endpoint webhook en dehors des hôtes de test (webhook.site).
404 not_found
Station, morceau, artiste ou ressource inexistant, ou aucun titre en direct n’a encore été observé pour la station.
404 station_opted_out
La station existe dans l’annuaire mais a demandé à ne pas être indexée. Tuneping n’en donne pas la raison. Considérez-la comme définitivement indisponible.
406 not_acceptable
L’en-tête Accept ne liste aucun des types de média pris en charge. Le corps reste du application/problem+json.
409 conflict
Ressource en double, par exemple un second endpoint webhook avec la même URL.
409 idempotency_in_progress
Une requête avec le même Idempotency-Key est toujours en cours. Réessayez après Retry-After secondes pour recevoir sa réponse.
410 endpoint_sunset
L’endpoint a été retiré après la date Sunset annoncée ; un en-tête Link pointe vers l’entrée correspondante du changelog.
413 payload_too_large
Les corps de requête sont limités à 64 KiB ; PUT /v1/wishlists accepte jusqu’à 1 MiB.
422 validation_failed
Un ou plusieurs paramètres ont des valeurs invalides. errors[] donne pour chacun field, code et un message lisible.
422 idempotency_key_reused
L’en-tête Idempotency-Key a déjà été utilisé dans les dernières 24 heures pour une autre requête (méthode, chemin, paramètres ou corps). Envoyez une nouvelle clé pour une nouvelle requête.
429 rate_limited
Le seau à jetons par seconde est vide. Attendez Retry-After secondes ; l’en-tête RateLimit nomme la politique épuisée.
429 too_many_connections
La clé a déjà autant de flux d’événements ouverts que son offre le permet (Developer 1, Pro 5, Business 20, Tapelark 1 par appareil). Fermez-en un d’abord.
429 quota_exceeded
Le quota quotidien ou mensuel est épuisé. Retry-After et quota_resets_at indiquent quand il se réinitialise ; upgrade_url renvoie vers les tarifs.
500 internal_error
Quelque chose a échoué de notre côté. Réessayez avec un délai croissant et envoyez-nous l’identifiant de la requête si le problème persiste.
503 unavailable
La base de données est indisponible ou le service est en maintenance, ou une requête avec un Idempotency-Key était toujours en cours après 20 secondes et a été annulée sans rien modifier. Réessayez après Retry-After secondes, valeur également donnée dans retry_after_seconds (1 pour la requête annulée ; renvoyez-la avec la même clé).

Retour à la référence de l’API