Wij gebruiken cookies op deze site om jouw gebruikerservaring te verbeteren.

Skip to main content

Inhoudstafel

BelgIF OpenAPI common data types

Overzicht

BelgIF-OpenAPI, een set libraries van gemeenschappelijke data types georganiseerd per domein, om een REST API te beschrijven en aldus te hergebruiken in OpenAPI (Swagger)-specificaties

Domein

Generieke IT-bouwblokken

Subdomein

Software factory - niet-veiligheidsgerelateerd

Typologie

Library

Service owners

FOD Financiën, Smals, KSZ, eHealth, BOSA, RSZ

Eerste release

2019

Hergebruik

meer dan 30

Integration effort

Waarvoor dient het?

Ontwikkel je een REST-service met identificatiegegevens van de sociale zekerheid (zoals INSZ, ondernemingsnummer...), gezondheidszorgen, datums, bedragen, landcodes, gewesten, gemeenten...? Verwijs dan eenvoudigweg naar de BelgIF OpenAPI-schemas in je OpenAPI-document.

Bovendien kan je testen of je OpenAPI-document voldoet aan de REST-guidelines, gepubliceerd op BelgIF, met behulp van de plug-in die je ter beschikking gesteld wordt op GitHub.

Functionele beschrijving

Een werkgroep, bestaande uit functionelen van FOD BOSA, eHealth, KSZ, FOD Financiën en Smals, heeft de meest gangbare bedrijfsontologieën (Person, Organization, Location, Temporal, Generic...) gestandaardiseerd.

Deze samenwerking resulteerde in

  • enerzijds, de publicatie van een terminologielijst van klassen en eigenschappen, met hun URI's, die door de federale overheid als standaardterminologie wordt aanvaard (Belgif vocabularies). Deze terminologie is afkomstig uit drie bronnen: federale overheidsdiensten, Vlaanderen en EU-standaarden. Elk element van de lijst heeft een numerieke identificator (zonder betekenis), een naam (in het Engels, camelCase) en een definitie
  • anderzijds, libraries van gemeenschappelijke data types (Belgif OpenAPI schemas) in overeenstemming met de Belgif vocabularies en de Belgif REST guidelines

BelgIF-OpenAPI definieert data types in de volgende domeinen:

  • organization-identifier
  • organization
  • employment-identifier
  • person-identifier
  • person
  • location
  • healthcare
  • time
  • money
  • problem
  • common (common technical data types)
Alle types zijn beschikbaar in de OpenAPI 2.0 (Swagger) en OpenAPI 3.0 formaten.

Er kan vanuit andere OpenAPI-documenten naar de data types worden verwezen: 
“$ref”: “./belgif/person/identifier/v1/person-identifier-v1.yaml#/components/schemas/Ssin”

Er is ook plug-in beschikbaar op GitHub om je OpenAPI-document te valideren of deze voldoet aan de REST-guidelines gepubliceerd op BelgIF.

Technische beschrijving

Veelgebruikte OpenAPI-2.0 en 3.0-gegevenstypes worden onderhouden in de belgif openapi-* GitHub repositories, georganiseerd per domein. Typen met een bèta-status bevinden zich in de broncode, maar maken geen deel uit van de vrijgegeven artefacten. Apache Maven-gebruikers kunnen ze ook downloaden van Maven Central.

Doelpubliek

De libraries BelgIF-OpenAPI common data types kunnen gebruikt worden door iedereen die een REST API ontwikkelt, waarbij de interoperabiliteit tussen alle gebruikte API's wordt verbeterd.

Als u wenst bij te dragen door opmerkingen te formuleren over de standaarden, ze mee vorm te geven of er intern/extern over te communiceren, dan kan u een issue openen op het geschikte project (belgif-openapi, FedVoc, REST guide), of een mail sturen naar fsp@gcloud.belgium.be.

Integratievoorwaarden

De libraries BelgIF-OpenAPI common data types zijn als open source gepubliceerd onder de licentie 2.0 van Apache en gratis te downloaden op GitHub of als Maven-artifacts op Maven Central.

Documentatie

Contact

Contact: ReuseOperational@smals.be

Maak deel uit van iets groters: join the ReUse movement

Vul de catalogus aan

Communicatie, kerndiensten, ondersteunende diensten, generieke IT-bouwblokken; het zijn allemaal business domeinen die je kunt verrijken met je eigen herbruikbare componenten, nuttig voor andere instellingen. Bovendien kunnen ze betrekking hebben op gebieden die we verder willen ontwikkelen zoals betalingen, rapportage, HR, enz.

Naar informatie en formulier

Word ambassadeur van het hergebruik!

Blader door de catalogus voor meer informatie over herbruikbare onderdelen. Praat met je werknemers en hun netwerken over de voordelen van ReUse.

Hoe meer bekendheid je geeft aan het ReUse-concept en de catalogus verrijkt, hoe meer je de voordelen ervan versterkt.

Volg ons!

Blijf op de hoogte van de laatste ontwikkelingen en events! Schrijf je in op onze nieuwsbrief.

Raadpleeg al onze nieuwsbrieven

Naar boven