Aller au contenu

Conformité

Avant d’ouvrir la production, nous vérifions que votre intégration tient dans les cas qui font mal : un rejeu, des nuits déjà prises, une signature falsifiée, un 429. Ces vérifications ne reposent pas sur votre déclaration : elles sont calculées sur votre journal d’appels et sur nos livraisons de webhooks.

Fenêtre de terminal
curl https://sandbox.localoge.com/api/v1/channel/conformance \
-H "Authorization: Bearer $LOCALOGE_TEST_KEY"
{
"success": true,
"environment": "sandbox",
"data": {
"passed": 12,
"failed": 1,
"warnings": 2,
"checks": [
{ "id": "auth", "label": "Authentification", "status": "pass", "detail": "GET /ping a répondu 200." },
{ "id": "dates_conflict", "label": "Conflit de dates (409)", "status": "fail", "detail": "Réservez des nuits déjà prises avec un autre identifiant : vous devez recevoir 409." }
]
}
}

status vaut pass, fail, warn ou todo. Quand un contrôle n’est pas satisfait, detail dit quoi faire. Le même tableau s’affiche dans l’espace développeur, onglet Conformité.

Deux niveaux. Un contrôle bloquant non satisfait vaut fail et empêche la demande de production. Un contrôle conseillé non satisfait vaut seulement warn.

id Contrôle Ce qui le fait passer Niveau
auth Authentification GET /ping a répondu 200. bloquant
property_created Création d’un logement Au moins un logement créé. bloquant
property_idempotent Republication idempotente Un logement renvoyé à l’identique a répondu 200 sans doublon (unchanged: true). conseillé
property_published Logement complet Au moins un logement publié ou en validation (3 photos, prix, capacité). bloquant
availability Disponibilités Un PUT …/availability a répondu 200. bloquant
rates Tarifs et restrictions Un PUT …/rates a répondu 200. bloquant
reservation_sent Réservation envoyée Un POST /reservations a répondu 201. bloquant
reservation_replay Rejeu idempotent Le même POST /reservations rejoué a répondu 200, même reservation_id. bloquant
dates_conflict Conflit de dates Un 409 DATES_UNAVAILABLE a été reçu. bloquant
cancellation Annulation Un POST /reservations/{id}/cancel a répondu 200. bloquant
webhook_registered Webhook enregistré Une URL de réception est active. bloquant
webhook_delivered Webhook reçu Au moins une livraison acquittée en 2xx par votre serveur. bloquant
webhook_failures Pas d’échec de livraison Aucun événement abandonné après 7 tentatives. conseillé
webhook_signature Vérification de signature Le miroir a reçu au moins un envoi : comparez notre verdict au vôtre, et vérifiez que vous refusez une signature falsifiée. conseillé
reservations_pull Rattrapage GET /reservations a été appelé. conseillé
properties_pull Lecture paginée GET /properties a été lu. conseillé
rate_limit Respect du débit Moins de 20 refus 429 : vous respectez Retry-After et X-RateLimit-Remaining. conseillé

La demande d’accès à la production, depuis https://developers.localoge.com/app/dev, est refusée tant qu’un contrôle est en fail : la réponse est un 409 conformite_incomplete accompagné du détail des contrôles manquants. Les warn n’empêchent pas la demande.

Une conformité au vert ne remplace pas la relecture de votre premier logement réel : il passe en pending_validation et un administrateur le regarde avant publication. Voir Cycle de vie.