API publique

L’API publique expose en lecture les données de l’annuaire DPS77. Elle est destinée aux portails institutionnels, aux cartographies territoriales et aux outils d’aide à l’orientation.

Principes

Lecture seule, format JSON
Pas d’authentification pour les données publiques
Rate limiting à 60 requêtes par minute par adresse IP
Pagination par curseur

Endpoints principaux

Liste des professionnels


GET /api/v1/professionals?territory=77&specialty=medecine-generale

Paramètres acceptés : territory (code INSEE ou département), specialty (code spécialité DPS77), page_size (10 à 100), cursor.

Fiche d’un professionnel


GET /api/v1/professionals/{national_id}

national_id correspond à l’identifiant national du professionnel (ex-RPPS). La réponse contient les coordonnées publiques, les spécialités, les structures de rattachement et les horaires.

Liste des structures


GET /api/v1/organizations?territory=77&type=cpts

type accepte les grandes catégories : cpts, msp, csp, hopital, ehpad, laboratoire.

Fiche d’une structure


GET /api/v1/organizations/{organization_national_id}

Identifiant national de la structure (ex-FINESS).

Format de réponse

Chaque réponse suit le même schéma :


{
  "data": [ /* objets */ ],
  "pagination": {
    "next_cursor": "eyJpZCI6MTIzfQ",
    "has_more": true
  }
}

Les données retournées sont publiques par conception. Aucune donnée patient, aucune donnée à caractère personnel non publiée, n’est accessible par cette API.

Rate limiting et bonnes pratiques

Mettre en cache côté appelant (TTL recommandé : 1 heure)
Utiliser la pagination plutôt que télécharger l’annuaire entier
Respecter l’en-tête Retry-After en cas de 429

Pour aller plus loin

Besoin d’aide ? Contactez l’équipe DirectProSanté 77 : contact@directprosante.fr