Présentation de l'API
Notre API vous permet de vérifier en temps réel si un professionnel de santé est bien en activité via son numéro RPPS. Cette API est un outil essentiel pour les sites web réservés aux professionnels de santé (PdS) afin de valider l’accès aux contenus restreints.
L’Annuaire Santé rassemble des données d’identification des professionnels et de leurs structures issues des référentiels nationaux tels que le RPPS, ADELI, et FINESS. Notre API exploite ces données publiques et en libre accès pour offrir une solution rapide et fiable aux développeurs de sites tiers.
Pour en savoir plus sur l’extraction des données en libre accès des professionnels intervenant dans le système de Santé, voici le lien vers le site officiel : https://annuaire.sante.fr/web/site-pro/extractions-publiques
Fonctionnalités de l'API
Assurez-vous en un instant qu'un numéro RPPS correspond bien à un professionnel de santé en activité.
L'API utilise les données disponibles sur l'annuaire esanté, garantissant une information exacte et à jour.
L’intégration de notre API ne nécessite qu’une seule requête HTTP. Vous pouvez facilement ajouter cette fonctionnalité à vos formulaires ou systèmes d’authentification.
Obtenez une réponse rapide pour confirmer l'identité et le statut du professionnel de santé.
Tarification
50 € HT par mois par site tiers
Le tarif couvre les frais de développement, d’hébergement et de maintenance de l’API. Il ne s’agit pas d’une monétisation des données des professionnels de santé, qui restent gratuites et accessibles sur l’annuaire esanté (https://annuaire.sante.fr/).
La facturation se fait uniquement annuellement (à date) et la tarification s’applique par site tiers. Si vous souhaitez utiliser cette API pour plusieurs sites de votre organisation, merci de nous contacter via le formulaire en bas de page.
Une fois le paiement annuel effectué, vous recevrez une clé API par email, vous donnant un accès immédiat à l’API. L’API est limitée, à date, à 2 requêtes / IP / seconde, n’hésitez pas à nous contacter pour toute demande supérieure.
Documentation
Accès API
Pour vérifier si un Professionnel de Santé est bien en activité, la requête est la suivante :
Variables à modifier
- {{rpps_recherche}} : à remplacer par le numéro RPPS
- {{client_api_key}} : à remplacer par la clé API reçue par email
Retours possibles
Numéro RPPS non valide ou introuvable
Numéro RPPS valide
Note : Les données présentées dans les exemples sont anonymisées pour protéger la confidentialité des professionnels de santé.
Erreurs statuts
- Erreur 429 : trop de requêtes à l’API (maximum de 2 requêtes / seconde / IP pour l’instant)
- Erreur 401 : mauvaise clé API – erreur d’authentification
Intégration
Intégrez facilement notre API dans vos formulaires pour vérifier les numéros RPPS lors de la création de comptes ou de l’accès à des contenus réservés aux professionnels de santé.
Exemple PHP
Exemple JS (validation côté client)
Exemple Node.js (validation côté serveur)
Nécessite l’utilisation d’un package tel que axios
Contact / support
Support et Assistance
Notre équipe est disponible pour vous assister dans l’intégration de l’API. N’hésitez pas à nous contacter pour toute question ou besoin d’aide technique.
Formulaire de contact
Pour toute question concernant l’API ou pour en savoir plus sur les tarifications possibles pour plusieurs sites tiers, veuillez nous contacter via le formulaire suivant.