Guide rapide pour les développeurs
Portée : Cette page s’adresse aux développeurs qui doivent récupérer ou intégrer des métadonnées lisibles par machine à partir du point de données FAIR public de Sciensano. Elle évite volontairement les explications génériques et laisse la gestion complète du contrat du point de terminaison à Swagger/OpenAPI.
Le FAIR DATA POINT public de Sciensano expose des métadonnées lisibles par machine via une API REST. Les enregistrements de métadonnées publiés peuvent être récupérés sans authentification à l'aide de requêtes HTTP GET et de la négociation de contenu RDF. Les développeurs peuvent demander des métadonnées aux formats Turtle, JSON-LD, RDF/XML ou N3 en configurant l'en-tête Accept approprié.
1. Points d'entrée
| Item | Valeur |
| URL de Base | https://public-fdp.sciensano.be |
| Swagger UI | https://public-fdp.sciensano.be/swagger-ui/index.html# |
| Exemple d'URI dataset | https://public-fdp.sciensano.be/dataset/ded3eb94-3bb9-42ca-9ead-2fe24cedb19f |
| Documentation officielle de l'API du FDP | https://docs.fairdatapoint.org/en/latest/usage/api-usage.html |
2. Modèle de métadonnées
Les métadonnées exposées par ce FAIR Data Point sont décrites au moyen de HealthDCAT-AP.
HealthDCAT-AP est un profil d’application de DCAT-AP spécifique au domaine de la santé. Il définit la manière dont les catalogues, jeux de données, distributions, services de données et métadonnées associées doivent être décrits afin de soutenir la découverte et l’interopérabilité des données de santé dans le contexte de l’Espace européen des données de santé.
Les développeurs qui consomment cette API doivent interpréter les réponses RDF comme des métadonnées HealthDCAT-AP. Cela signifie que les descriptions de jeux de données peuvent inclure à la fois des propriétés standard DCAT/DCAT-AP et des propriétés spécifiques à HealthDCAT-AP.
Pour connaître la structure exacte des métadonnées, les classes, les propriétés et les vocabulaires contrôlés, consultez la spécification HealthDCAT-AP: https://healthdataeu.pages.code.europa.eu/healthdcat-ap/releases/latest/index.html
3. Modèle d'accès
Accès en lecture : les métadonnées publiées peuvent être récupérées via des requêtes GET publiques. Aucun jeton n’est requis pour la collecte standard des métadonnées.
| Action | Method | Endpoint pattern | Authentification | Notes |
| Récupérer les métadonnées | GET | /{prefix}/{uuid} | Aucun jeton pour les métadonnées publiées | Utilisez l'en-tête Accept pour choisir la sérialisation RDF. |
4. Préfixes de ressources
Les points de terminaison FDP sont orientés ressources. Chaque type de ressource de métadonnées est exposé via un préfixe d'URL. Les préfixes exacts sont configurés par l'instance FDP et doivent être confirmés dans Swagger. Voici quelques préfixes courants :
| Prefix | Ressource RDF/DCAT | Usage |
| /catalog/{uuid} | dcat:Catalog | Récupérer les métadonnées du catalogue et les liens vers les ressources qu'il contient. |
| /dataset/{uuid} | dcat:Dataset | Récupérer les métadonnées de l'ensemble de données, notamment le titre, la description, l'éditeur, les thèmes et les distributions. |
| /distribution/{uuid} | dcat:Distribution | Récupérer les métadonnées au niveau de la distribution, telles que l'URL d'accès, le format, le type de média ou la licence. |
Important : Utilisez les identifiants renvoyés dans les liens RDF. Ne pas extraire de données de l’interface utilisateur HTML et ne pas construire les URL des ressources enfants en supposant que l’URI est déjà fournie dans les métadonnées.
5. Négotiation de contenu
Utilisez l'en-tête HTTP Accept pour demander la sérialisation RDF dont vous avez besoin.
| Serialisation | Accept header | When to use |
| Turtle | text/turtle | Recommended for developers and RDF tooling; compact and readable. |
| JSON-LD | application/ld+json | Useful for web applications and JSON-based integration. |
| RDF/XML | application/rdf+xml | Useful for legacy RDF/XML pipelines. |
| N3 | text/n3 | Useful if your RDF stack expects N3. |
6. Récupérer les métadonnées
Récupérer un jeu de données sous forme de Turtle :
| curl -H "Accept: text/turtle" \ https://public-fdp.sciensano.be/dataset/ded3eb94-3bb9-42ca-9ead-2fe24cedb19f |
Récupérer le même jeu de données au format JSON-LD :
| curl -H "Accept: application/ld+json" \ https://public-fdp.sciensano.be/dataset/ded3eb94-3bb9-42ca-9ead-2fe24cedb19f |
Exemple Python :
| import requests uri = "https://public-fdp.sciensano.be/dataset/ded3eb94-3bb9-42ca-9ead-2fe24cedb19f" headers = {"Accept": "text/turtle"} response = requests.get(uri, headers=headers, timeout=30) response.raise_for_status() print(response.text) |
7. Liste de contrôle de le moissonnement
- Commencez par l'URL de base FDP connue et/ou les ressources de catalogue exposées par l'instance.
- Demander du RDF avec un en-tête Accept clair ; Turtle est généralement le plus simple pour les pipelines RDF.
- Suivez les liens RDF vers les catalogues, ensembles de données et distributions associés au lieu d'extraire des données des pages HTML.
- Conservez l'URI et l'UUID de la ressource ; utilisez-les comme identifiants stables dans les tâches de synchronisation en aval.