BelgIF-OpenAPI, un ensemble de librairies de types de données communes organisées par domaine, pour décrire une API REST et ainsi la réutiliser dans les spécifications OpenAPI (Swagger)
Un groupe de travail fonctionnel composé du SPF BOSA, d'eHealth, de la BCSS, du SPF Finances et de Smals a collaboré pour standardiser les ontologies business les plus courantes (Personne, Organisation, Lieu, Temps, Générique, etc).
Cette collaboration a abouti
BelgIF-OpenAPI définit des types de données dans les domaines suivants :
Tous les types sont disponibles dans les formats OpenAPI 2.0 (Swagger) et OpenAPI 3.0.
Les types de données peuvent être référencés à partir d'autres documents OpenAPI :
“$ref”: “./belgif/person/identifier/v1/person-identifier-v1.yaml#/components/schemas/Ssin”
Les librairies BelgIF-OpenAPI common data types peuvent être utilisés par quiconque développe une API REST, améliorant ainsi l'interopérabilité entre toutes les API utilisées.
Si vous souhaitez contribuer en commentant les standards, en aidant à les façonner ou en communiquant à leur sujet en interne/externe, vous pouvez ouvrir un ticket sur le projet approprié (belgif-openapi, FedVoc, REST guide), ou envoyez un e-mail à fsp@gcloud.belgium.be.
Les librairies BelgIF-OpenAPI common data types sont publiées en open source sous la licence Apache 2.0 et sont disponibles gratuitement en téléchargement sur GitHub ou sous forme d'artefacts maven sur Maven Central.
Contact : ReuseOperational@smals.be
Vous avez un composant réutilisable qui pourrait intéresser d’autres institutions ?
Vous aimeriez échanger au sujet de la réutilisation ? Des évènements sont régulièrement organisés.
Inscrivez-vous à la newsletter pour suivre l’actualité autour de la réutilisation.
Réutiliser un composant vous a aidé à transformer un projet en réussite ?