Sur /api ], vous trouverez un aperçu interactif de Statusgegevens et Zoekresultaten, créé à l'aide de Swagger UI à partir d'une spécification OpenAPI. Pour chaque adresse, le visiteur peut voir quels sont les paramètres pris en charge et les données renvoyées, et peut tester un appel directement depuis la page, sans avoir à écrire son propre programme.
Télécharger
La spécification est disponible à deux adresses, /api/openapi.json et /api/openapi.yaml, toutes deux au format OpenAPI. En haut de chaque page se trouve un bouton. Ceux qui préfèrent générer leur propre client plutôt que d'utiliser la page interactive peuvent télécharger l'un des deux fichiers et l'intégrer à leur propre outil.
La page elle-même
La page comporte le logo de BesluitBron, un lien vers le site et la langue du visiteur, tout comme le reste du site. Les deux boutons de téléchargement reprennent la même mise en page que les autres boutons du site. Ce que Swagger UI affiche de lui-même, à savoir la barre « Explore » et le texte de chaque bouton situé en dessous, reste en anglais : cette partie provient de l'outil lui-même et n'est pas traduite.
L'adresse figure également dans le pied de page de chaque page, sous la rubrique « Sources », à côté de « Santé ».
Ce qui n'y figure pas
La liste se limite aux deux adresses disponibles à l'adresse /api. Les explorateurs de la console d'administration et les exportations de l'écran de recherche ne constituent pas des adresses de programme publiées et ne figurent donc pas dans cette spécification ; voir Verkenner.
Sur une installation qui ne porte pas le nom « Production », s'y ajoutent les cinq adresses du lien d'auto-enregistrement pour l'automatisation (/api/automation/...). Ce lien ne fonctionne que lorsqu'une clé a été définie, voir Installatie ; sans cette clé, chacune des cinq adresses répond de la même manière à chaque requête, comme si l'adresse n'existait pas.