Se connecter à l’API VetCoreSolution®
Découvrez comment s’authentifier sur l’API VetCoreSolution® et accéder aux données d’une clinique en lecture seule.
1Création d’un compte développeur
Pour utiliser l’API VetCoreSolution®, vous devez posséder un compte utilisateur valide. L’inscription est gratuite.
- Adresse email et mot de passe
- Ou via un fournisseur OpenID (Google, Microsoft, GitHub, etc.)
La liste des fournisseurs OpenID est susceptible d’évoluer.
2Accès à une clinique
Pour accéder aux données d’une clinique via l’API, celle-ci doit vous avoir invité avec l’une de ses licences développeur externes.
Étape 1 : La clinique génère un code d’association
Dans le panneau de configuration de la clinique, un gestionnaire peut générer un code d'association qu’il vous communiquera par email ou tout autre moyen.
Panneau d'invitation de logiciel externe
Les codes d'association expirent après 72 heures. Passé ce délai, un nouveau code devra être généré.
Étape 2 : Vous confirmez l’ajout avec le code fourni
Trois méthodes sont possibles pour valider votre rattachement :
- Cliquer sur le lien d'activation reçu et s'authentifier
- Saisir manuellement le code d'association depuis votre profil dans l’application VetCoreSolution®
- Appeler directement l’API
La méthode recommandée est l’appel direct à l’API :
POST https://vetcoresolution.com/api/establishments/join?assignmentCode=YOUR-CODE-HERE
Authorization: Bearer {your-jwt-token}Les accès API obtenus via une licence externe sont strictement en lecture seule (GET). Aucune opération de création, modification ou suppression n’est autorisée.
3Authentification
L’authentification s’effectue par token JWT obtenu via un appel POST au endpoint `/api/account/login` avec vos identifiants VetCore.
POST https://vetcoresolution.com/api/account/login
Content-Type: application/json
{
"email": "you@example.com",
"password": "yourPassword",
"withHttpOnlyCookie": true
}Le paramètre `withHttpOnlyCookie` permet de demander un cookie sécurisé HttpOnly en complément du token JWT retourné.