Votre outil lit l’agenda, et il reçoit chaque rendez-vous signé.

Vous lisez trois choses d’un salon, et chacune est promise

Sous /api/v1/public, vous lisez l’identité du salon, son catalogue actif et les créneaux d’une journée ; toute autre adresse répond 404, avec la liste des trois routes.

Chaque champ reçu est promis : notre modèle interne peut bouger, votre lecture ne bouge pas ; un prix qui se chiffre sur place se dit « sur demande », jamais 0.

• Chaque réponsesa version de contrat, l’identifiant du salon, l’en-tête X-Api-Version
• Chaque erreurun code stable à tester, un message lisible
• Cache-Control: private, no-storesur toute réponse, refus de débit compris

Vous lisez l’heure du salon, et « fermé » se distingue de « complet »

« 14:30 » est 14 h 30 sur place : chaque heure s’exprime dans le fuseau du salon, que la route salon vous donne.

Vos créneaux suivent les règles du salon : heures de l’équipe, congés, fermetures ; une prestation qui exige d’abord une visite ne rend pas de planning. Deux drapeaux disent pourquoi une journée est vide.

Votre clé ouvre un salon, en lecture, et rien d’autre

Nous vous la remettons avec un libellé et votre adresse de contact technique ; elle s’affiche une seule fois, nous n’en gardons que l’empreinte. Deux outils, deux clés.

Vos données viennent de votre clé, jamais de l’adresse appelée : votre clé ne lit que vos données, sur votre domaine comme sur votre adresse Co-Labs. Un jeton interne n’ouvre rien ici.

• Formeclk_ suivi de 32 octets tirés au hasard
• En-têteAuthorization: Bearer ou X-API-Key
• Périmètreun seul, public:read : aucune écriture en v1
• Débit120 requêtes par minute, comptées par clé

Chaque rendez-vous vous parvient, signé

Créé, annulé ou déplacé — sur le site, avec Liah au téléphone ou par écrit, au comptoir — le rendez-vous vous est annoncé par un POST signé, canal d’entrée compris ; un test de notre dépôt vérifie que chaque chemin qui écrit un rendez-vous l’annonce.

Chaque livraison porte Colabs-Signature: t=<horodatage>,v1=<HMAC-SHA256>, calculé sur l’horodatage et le corps tel qu’il part. Vérifiez-la à temps constant, dans une fenêtre de cinq minutes ; Colabs-Event-Id et Colabs-Attempt vous laissent dédoublonner une reprise.

• Événementsrdv.cree, rdv.annule, rdv.deplace, et pas un de plus
• Secretun par abonnement, montré une fois, chiffré au repos
• Charge utileune référence opaque, date, heure, durée, prestation, statut, canal
• Aucune donnée personnelleni nom, ni téléphone, ni e-mail, ni note
• Essai à blancun webhook.test depuis notre console

Votre serveur peut tomber : l’événement vous attend

Rien ne part pendant la réservation de la cliente : l’événement est gardé chez nous puis porté vers vous, et la réservation aboutit même si votre serveur est en maintenance. Sept essais sur environ 8 h 45 : un rendez-vous du lendemain matin arrive à temps.

Une réponse 2xx vaut succès ; tout le reste est un échec, redirection comprise. Après cinq abandons d’affilée, l’abonnement se met en pause ; nous le relançons avec vous, compteur remis à zéro.

• Essaisimmédiat, puis 10 s, 1 min, 5 min, 30 min, 2 h, 6 h
• Échéance10 secondes par livraison
• Votre adresseHTTPS exigé, adresses privées refusées, aucune redirection suivie
• Mémoireune livraison terminée s’efface après 30 jours, jamais une livraison en attente

Votre intégration tient dans le temps

La version vit dans le chemin, v1, et la révision du contrat dans chaque réponse. Un champ, une route ou une valeur peuvent s’ajouter : prévoyez un cas par défaut. Rien d’existant ne disparaît ni ne change de sens — ce serait une v2, et notre contrat écrit tient alors la v1 au moins douze mois, avec les en-têtes Deprecation et Sunset.

L’adresse de contact laissée à la remise de la clé est exigée : c’est par elle que nous vous prévenons.