Intégrations
DPS77 n’est pas un silo. Les données de l’annuaire peuvent être consommées, synchronisées ou enrichies par des systèmes tiers (logiciels métiers, portails institutionnels, plateformes de prise de rendez-vous, systèmes d’information hospitaliers).
Trois modes d’intégration coexistent, selon le besoin.
Les trois modes
API publique (lecture)
Récupérer des fiches professionnels ou structures par territoire, spécialité ou identifiant national. Pas d’authentification, usage libre sous conditions raisonnables. C’est la voie recommandée pour les portails institutionnels et les cartographies.
Webhooks (événements)
S’abonner aux événements de DPS77 (création, mise à jour, signalement) pour maintenir un système aval synchronisé sans avoir à interroger l’API en permanence. Le système de l’abonné reçoit une requête HTTPS signée dès qu’un événement survient.
OAuth 2.0 (écriture au nom d’un administrateur)
Permettre à un logiciel tiers d’agir au nom d’un administrateur DPS77 (mise à jour de fiches, gestion de parcours). C’est le mode le plus exigeant : il faut enregistrer une application et respecter les portées (scopes) définies.
Quel mode choisir ?
| Besoin | Mode recommandé |
|---|---|
| Afficher des fiches sur un site institutionnel | API publique |
| Synchroniser un annuaire interne avec DPS77 | Webhooks |
| Laisser un logiciel métier mettre à jour les fiches | OAuth 2.0 |
| Cartographier les ressources d’un territoire | API publique |
Toutes les intégrations sont gratuites pour les structures publiques et les éditeurs partenaires. Une limitation de débit (rate limiting) raisonnable protège le service contre les usages abusifs.
Pré-requis techniques
- Votre système doit parler HTTPS (TLS 1.2 minimum)
- Pour les webhooks, un point de terminaison (URL) public accessible par l’infrastructure DPS77
- Pour OAuth, un domaine de redirection déclaré
Pour aller plus loin
Besoin d’aide ? Contactez l’équipe DirectProSanté 77 : contact@directprosante.fr