Erreurs

Une erreur se reconnaît d'abord à son statut HTTP : 400 pour une requête incomplète, 401 pour une clé ou un jeton refusé, 404 pour une ressource introuvable, 500 pour une erreur de notre côté. Le corps prend l'une de ces deux formes.

Clé ou jeton refusé

Quand la clé, l'identifiant ou le jeton est refusé, la requête s'arrête avant l'endpoint. Le message, en anglais, commence par le code de l'erreur :

HTTP/1.1 401 Unauthorized

{"error": "103 - Invalid login credentials."}

Erreur d'un endpoint

Les autres erreurs ont la forme habituelle des réponses : le message est dans data, sans son code, seul ou dans une liste d'un élément selon l'endpoint. Il est le plus souvent traduit dans la langue du site, et ces messages peuvent changer : fiez-vous au statut HTTP, et affichez le message tel quel si besoin. Les erreurs de chaque endpoint sont dans la référence.

HTTP/1.1 404 Not Found

{"data": ["VDM introuvable."], "meta": {}, "badge": [], "badge_display": []}

Codes et messages