Aller au contenu
Localoge pour les développeurs

Erreurs

Toutes nos réponses portent la même enveloppe : vous n’avez qu’un cas à écrire.

{
  "success": false,
  "error": {
    "code": "PROPERTY_NOT_FOUND",
    "message": "Property not found",
    "request_id": "req_9f2c1a44-8e3b-4d21-b0c7-5e6f7a8b9c0d"
  }
}

En cas de succès :

{ "success": true, "data": { } }

request_id : citez-le nous

Section intitulée « request_id : citez-le nous »

Chaque réponse d’erreur en porte un, et nous le conservons avec votre appel : la méthode, le chemin, la durée, le code, et l’identifiant du logement ou de la réservation concernés.

Écrivez-nous en le citant, et nous retrouvons votre requête immédiatement. Sans lui, un diagnostic commence par « à quelle heure exactement, et avec quelle clé ? ». Journalisez-le de votre côté sur chaque erreur.

Les codes

Section intitulée « Les codes »

Ils sont stables. Nous en ajouterons, nous n’en renommerons jamais : vous pouvez les tester dans votre code sans craindre qu’une de nos mises à jour le casse.

Code HTTP Ce qu’il faut faire
UNAUTHORIZED 401 Clé absente, mal formée, révoquée ou expirée. Vérifiez l’en-tête.
FORBIDDEN 403 Clé valide, mais l’opération est refusée. Le message précise. Écrivez-nous.
RATE_LIMITED 429 Trop d’appels. Voir Limites.
INVALID_PAYLOAD 400 Corps invalide. Le message nomme le premier champ fautif.
PROPERTY_NOT_FOUND 404 Ce external_property_id n’existe pas. Poussez le logement d’abord.
RESERVATION_NOT_FOUND 404 Ce external_reservation_id n’existe pas.
DATES_UNAVAILABLE 409 Ces nuits sont déjà prises chez nous. Ne réessayez pas, rapprochez vos calendriers.
PAYOUT_ACCOUNT_MISSING 409 Logement en owner dont le propriétaire n’a pas activé son compte.
UNSUPPORTED 422 Route inconnue, ou opération non gérée pour ce logement.
INTERNAL 500 Notre faute. Réessayez plus tard, et signalez-le nous.

Ce qu’il faut réessayer, et ce qu’il ne faut pas

Section intitulée « Ce qu’il faut réessayer, et ce qu’il ne faut pas »

Réessayez sur 429 (en respectant Retry-After), sur 500, et sur toute erreur réseau.

Ne réessayez pas sur 400, 401, 403, 404 et 409 : le même appel donnera le même résultat. Une boucle de réessai sur un 400 consomme votre quota et n’a jamais rien réparé.