Des problem details sur lesquels brancher

Chaque erreur est un problem details RFC 9457 : une URL type stable qui mène à sa ligne ci-dessous, le statut HTTP, un detail qui dit quoi corriger, l'id de la requête dans instance, et des suggestions quand une correspondance proche existe.

Lire la référence

404 application/problem+json

{
  "type": "https://arbitron.app/developers/errors#unknown-coin",
  "title": "Unknown coin",
  "status": 404,
  "detail": "No venue quotes a perpetual on 'ETHEREUM'. GET /api/v1/coins?q=ETHEREUM lists close matches.",
  "instance": "0HN7Q2K3J9R4P:00000001",
  "code": "unknown-coin",
  "docs": "https://arbitron.app/developers/errors",
  "suggestions": ["ETH", "ETC", "ETHFI"]
}

Tous les codes d'erreur

400 invalid-parameter

Une valeur de requête est hors plage ou de mauvaise forme. detail nomme le paramètre et les valeurs acceptées.

401 unauthenticated

Pas de clé, ou une clé mal saisie, révoquée, expirée ou sortie par rotation. Envoyez l'en-tête Authorization en Bearer avec une clé créée sur la page « Assistants IA et API ».

403 scope-missing

La clé a été créée sans le scope que cet endpoint exige ; detail liste ceux qu'elle a. Créez une clé avec ce scope.

403 plan-limit

La requête dépasse le plan : une fenêtre d'historique plus profonde que ce qu'il inclut, ou une page plus grande que ce que la démo renvoie. Réduisez la requête ou passez au plan supérieur.

404 unknown-coin

Aucun exchange ne cote de perpétuel sur ce ticker. suggestions porte les rapprochements, et GET /api/v1/coins avec le paramètre q cherche.

404 unknown-exchange

Cet exchange n'est pas servi par l'API. suggestions liste les exchanges, comme GET /api/v1/exchanges.

404 unknown-card

Aucune carte de ce compte n'a ce card_ref. Prenez le card_ref renvoyé par GET /api/v1/me/cards : il ne vaut que pour votre compte.

404 not-found

Aucun endpoint à ce chemin sous /api/v1. GET /api/v1 liste ceux qui existent.

429 rate-limited

La fenêtre de la minute est épuisée, ou trop de clés refusées viennent d'une même adresse. Attendez Retry-After secondes, ou réglez le rythme du client sur l'en-tête RateLimit.

429 quota-exhausted

Les requêtes du mois sont consommées. Le quota se remet à zéro le 1er à 00:00 UTC ; un plan supérieur en a davantage.

503 snapshot-unavailable

Le snapshot derrière l'endpoint se recharge encore après un redémarrage. Réessayez dans une minute.

503 api-disabled

L'API n'est pas activée sur cet hôte. Rien à changer de votre côté, c'est une faute de configuration du nôtre.