API partenaires
Brancher un logiciel tiers sur Treats : prise de rendez-vous, laboratoire, imagerie, comptabilité, siège de groupe. Ce que l'API permet, comment l'accès est donné, par où commencer.
API partenaires
L’API partenaires permet à un éditeur de logiciel de travailler avec les cliniques vétérinaires qui utilisent Treats. Un service de prise de rendez-vous en ligne y lit les créneaux libres et pose des rendez-vous. Un laboratoire y lit les analyses demandées et y dépose ses résultats. Un outil comptable y lit les factures et les règlements. Un siège de groupe y suit l’activité de ses sites.
Adresse de production https://app.treats.vet/api/partner/v1. Adresse de recette https://preprod.treats.vet/api/partner/v1.
Le principe
- Une application par éditeur. Treats enregistre votre application et lui remet un identifiant et un secret. Treats fixe aussi les droits que l’application peut demander.
- Une autorisation par organisation. Chaque organisation cliente (une clinique ou un groupe) autorise votre application. Elle choisit les sites et les droits qu’elle accorde, jamais plus que ce que Treats a ouvert. Elle peut retirer l’autorisation à tout moment ; l’accès est coupé tout de suite.
- Un jeton par organisation. Votre serveur échange ses identifiants contre un jeton valable 60 minutes, lié à une organisation. Chaque appel porte ce jeton.
- Des brouillons, jamais des actes engagés. Vous créez et modifiez des rendez-vous, des clients, des animaux, des notes, des tâches, et vous remplissez une consultation en cours. Vous ne validez pas une consultation, ne signez pas une ordonnance, n’émettez ni n’encaissez une facture : l’équipe de la clinique garde ces gestes.
- Tout ce que vous écrivez est signé. À l’autorisation, Treats crée un utilisateur « Intégration, nom de votre application ». Il signe chacune de vos écritures (« Doctolib a déplacé le RDV ») et n’apparaît dans aucune liste d’équipe. Personne ne peut s’y connecter.
Ce que vous pouvez faire
Organisation
Sites, horaires, fermetures, salles, équipe, espèces et races.
Ouvrir→Clients et animaux
Lire, rechercher, créer et modifier les fiches, contrôler les doublons.
Ouvrir→Agenda
Créneaux libres, rendez-vous, annulation, arrivée, salle d’attente, notes d’appel et tâches.
Ouvrir→Consultations
Ouvrir une consultation, remplir ses modules, lire l’historique d’un animal et ses documents.
Ouvrir→Catalogue, factures, ordonnances
En lecture : actes et produits au prix du site, factures, avoirs, règlements, ordonnances signées.
Ouvrir→Laboratoire et imagerie
Lire les examens demandés à votre service, déposer les résultats et les comptes rendus.
Ouvrir→Votre application est aussi prévenue de ce qui change chez la clinique (rendez-vous créé, déplacé, annulé, patient arrivé, consultation validée, facture émise…) par des notifications signées.
Par où commencer
Demander une application de recette
Écrivez à partenaires@treats.vet : votre service, les données dont il a besoin, l’adresse de vos notifications. Treats vous remet les identifiants d’une application de recette, connectée à une organisation de test. Voir Recette et mise en production.
Faire le premier appel
Jeton,
GET /me, une liste, une écriture : le démarrage rapide prend dix minutes.Lire les règles communes
Accès et droits, conventions, synchronisation, erreurs et limites.
Chercher une route
La référence décrit chaque route avec ses paramètres, son corps, sa réponse champ par champ, ses erreurs et un exemple d’appel réel. La spec OpenAPI 3.1 se charge dans Postman, Insomnia ou un générateur de client.
Stabilité
L’API est versionnée dans son adresse (/v1). Dans une version, Treats peut ajouter des routes, des paramètres facultatifs et des champs de réponse : votre code doit ignorer un champ qu’il ne connaît pas. Retirer ou renommer un champ, changer son type ou le sens d’une valeur est un changement cassant, réservé à une nouvelle version annoncée à l’avance.
La clé API qu’une clinique crée elle-même (X-API-Key, adresses /api/v1) reste en service pour les intégrations existantes. Elle est décrite dans Clé API d’une clinique. Toute nouvelle intégration passe par l’API partenaires.