Clé API d’une clinique
Bienvenue sur la documentation de l'API publique Treats
Clé API d’une clinique
Ces pages décrivent la clé API qu’une clinique crée elle-même (X-API-Key, adresses /api/v1), conservée pour les intégrations existantes. Toute nouvelle intégration passe par l’API partenaires : une application enregistrée par Treats, autorisée par chaque organisation, avec écriture des rendez-vous, des clients, des consultations, des résultats de laboratoire et d’imagerie, et des notifications.
L’API Treats permet aux partenaires d’accéder aux données metier d’une clinique vétérinaire : patients, clients, rendez-vous, consultations, factures et stock.
Ce que vous pouvez faire
Patients
Consulter la liste des animaux et la fiche de chacun.
Clients
Acceder aux fiches proprietaires et a leurs coordonnees.
Rendez-vous
Consulter les types de rendez-vous, les creneaux disponibles et un rendez-vous.
Factures
Acceder aux factures et au suivi financier par client.
Consultations
Lire les comptes-rendus de consultations vétérinaires.
Stock
Suivre les niveaux de stock et les alertes de reapprovisionnement.
Concepts clés
Authentification par clé API
Chaque partenaire recoit une clé API unique (format vk_...) configurée par l’administrateur de la clinique. Cette clé determine :
- Les endpoints accessibles via un système de permissions granulaires
- Le niveau de détail des réponses (BASIC, STANDARD ou FULL)
- La limite de requêtes par heure (1000 par défaut)
Isolation par clinique
Chaque clé API est liée à une clinique. Vous n’accedez qu’aux données de la clinique qui vous a fourni la clé.
Lecture seule
Les guides de cette documentation décrivent des lectures, et une écriture : le dépôt des résultats d’imagerie par un partenaire d’imagerie. La création de rendez-vous n’est pas encore ouverte aux clés API.