Vous pouvez désormais développer directement sur Veridien. Le moteur qui alimente nos propres parcours de réservation vous est ouvert : moteur de réservation sur mesure, application mobile pour vos clients, intégration de fidélité ou n'importe quelle automatisation de back-office.
C'est une interface HTTP/JSON toute simple. Vous vous authentifiez avec une clé d'API propre à un établissement, vous envoyez et recevez du JSON en snake_case, et vous vous appuyez sur des codes de statut standard et une enveloppe d'erreur unique et uniforme. Chaque clé a ses portées, donc elle ne peut faire que ce que vous lui accordez, sur le seul établissement auquel elle appartient.
- Des clés d'API par établissement. Créez vos clés, définissez leurs portées et révoquez-les sous Paramètres → Clés d'API. Une clé n'est affichée qu'une fois et n'est stockée que sous forme de hachage.
- Un accès limité par portées. Douze portées granulaires (par exemple
availability:read,reservations:write,folio:write) protègent chaque endpoint, dont une portéeguests:read:piidistincte pour les données clients sensibles. - Tout le cycle de vie de la réservation. Cherchez des disponibilités, tarifez un séjour avec des tarifs filtrés par visibilité, enregistrez ou rattachez un client, bloquez de la disponibilité, confirmez une réservation payée et passez des frais sur la note.
- La fidélité. Lisez le solde et le niveau d'un client, échangez des points, et cumulez automatiquement sur les séjours confirmés.
- Des reprises sûres. Les requêtes de modification acceptent un en-tête
Idempotency-Key, si bien qu'une reprise réseau ne double jamais une réservation ni un encaissement. La confirmation de réservation est en outre idempotente sur sa référence de paiement. - Des erreurs prévisibles. Chaque échec renvoie une enveloppe typée avec un
codestable, unparamfacultatif et unrequest_id. - Un schéma OpenAPI 3.1. Une description exploitable par une machine de chaque endpoint est servie sur
/api/v1/openapi.jsonpour générer des clients typés.
| Domaine | Ce que vous pouvez faire |
|---|---|
| Catalogue | Lire l'établissement, les types de chambres, les disponibilités et les tarifs éligibles |
| Clients | Enregistrer ou rattacher des clients, lire et mettre à jour les fiches, lire la fidélité |
| Réservations | Bloquer de la disponibilité, confirmer, lister et lire des réservations, annuler |
| Notes | Lire la note d'une réservation et y passer des frais |
| Fidélité | Lire les soldes et les niveaux, échanger des points |
La référence complète, un démarrage rapide et des exemples à copier-coller se trouvent dans la documentation de l'API. L'URL de base est https://veridien.app/api/v1.