omnistate/annuaire-sante Référence de l’API

Omnistate\AnnuaireSante

AnnuaireSante class

final class AnnuaireSante implements ProfessionalRegistryInterface, FacilityRegistryInterface AnnuaireSante.php:30

The Annuaire Santé of the Agence du numérique en santé, through its FHIR API (version 2): health professionals by their RPPS number - profession, specialties, diplomas, where they practise and how, their MSSanté addresses - and health facilities by their FINESS number. Free, with a key from the ANS's Gravitee portal (header ESANTE-API-KEY), 17 calls a second. Production data only: the ANS has no sandbox with fictional people.

Without a key every call throws UnavailableException: not knowing is not "no such professional".

const URL = 'https://gateway.api.esante.gouv.fr/fhir/v2'

const PROFESSIONS = ['10' => 'Médecin', '21' => 'Pharmacien', '26' => 'Audioprothésiste', '28' => 'Opticien-lunetier', '40' => 'Chirurgien-dentiste', '50' => 'Sage-femme', '60' …

TRE_G15, the professions the register knows by code (the ones a practice meets).

AnnuaireSante::__construct()

public function __construct(readonly HttpClientInterface $http, readonly ?string $apiKey = null, readonly float $timeout = 10, readonly string $url = self::URL)

AnnuaireSante::name()

public function name(): string

AnnuaireSante::supports()

public function supports(string $identifier): bool

AnnuaireSante::supportsFacility()

public function supportsFacility(string $identifier): bool

AnnuaireSante::professional()

public function professional(string $identifier): ?Professional

AnnuaireSante::search()

public function search(string $name, ?string $postcode = null, int $limit = 10): array

AnnuaireSante::facility()

public function facility(string $identifier): ?Facility

AnnuaireSante::professionals()

public function professionals(array $bundle): array

The professionals of a search answer, each with the roles and the organizations it included.