Quickstart

Votre premier appel API en 2 minutes

1. Obtenez votre clé API

Demandez à l’administrateur de la clinique de créer une clé API pour votre intégration. Il vous fournira une clé au format :

vk_aBcDeFgHiJkLmNoPqRsTuVwXyZ...

La clé brute n’est affichée qu’une seule fois lors de sa creation. Stockez-la de maniere securisee.

2. Faites votre premier appel

Ajoutez la clé dans le header X-API-Key :

curl -H "X-API-Key: vk_votre_cle_ici" \
  https://app.treats.vet/api/v1/patients

const response = await fetch('https://app.treats.vet/api/v1/patients', {
  headers: {
    'X-API-Key': 'vk_votre_cle_ici'
  }
});

const patients = await response.json();
console.log(patients);

import requests

response = requests.get(
    'https://app.treats.vet/api/v1/patients',
    headers={'X-API-Key': 'vk_votre_cle_ici'}
)

patients = response.json()
print(patients)

$ch = curl_init('https://app.treats.vet/api/v1/patients');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: vk_votre_cle_ici'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$patients = json_decode($response, true);

3. Lisez la réponse

Selon le niveau d’accès configure sur votre clé, vous obtiendrez plus ou moins de champs. species est un code d’espèce (DOG, CAT…), sex vaut MALE, FEMALE, MALE_NEUTERED, FEMALE_SPAYED ou UNKNOWN. En FULL, la réponse porte tous les champs de la fiche ; l’exemple n’en montre qu’une partie.

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Rex",
    "species": "DOG",
    "breed": "Golden Retriever",
    "sex": "MALE"
  }
]

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Rex",
    "species": "DOG",
    "breed": "Golden Retriever",
    "sex": "MALE",
    "clientId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "birthDate": "2020-03-15",
    "microchipNumber": "250269810012345",
    "createdAt": "2024-01-10T09:30:00Z"
  }
]

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Rex",
    "species": "DOG",
    "breed": "Golden Retriever",
    "sex": "MALE",
    "clientId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "birthDate": "2020-03-15",
    "microchipNumber": "250269810012345",
    "photoUrl": "https://storage.treats.vet/photos/rex.jpg",
    "createdAt": "2024-01-10T09:30:00Z",
    "updatedAt": "2025-12-01T14:22:00Z"
  }
]

Prochaines etapes

Authentification

Détails sur les clés API

Ouvrir→

Niveaux d'acces

BASIC / STANDARD / FULL

Ouvrir→

Routes disponibles

Les routes ouvertes par permission

Ouvrir→