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.
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é.
Les contrôles
Section intitulée « Les contrôles »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é |
Et la production
Section intitulée « Et la production »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.