Hoe de KBO/BCE API in uw applicatie te integreren

In het kort

De KBO/BCE-API biedt toegang tot de officiële gegevens van meer dan 2 miljoen Belgische bedrijven geregistreerd bij de Kruispuntbank van Ondernemingen. In enkele minuten kunt u verzoeken authenticeren met een API-sleutel, de databank opvragen op naam of KBO-nummer en uw applicatie verrijken met actuele gegevens.

Inleiding

De KBO/BCE API geeft u toegang tot de officiële gegevens van meer dan 2 miljoen Belgische bedrijven. In deze handleiding laten we stap voor stap zien hoe u deze kunt integreren in uw applicatie.

Vereisten

Zorg ervoor dat u het volgende heeft voordat u begint:

• Een account op ons platform

• Een actieve API-sleutel (publiek en geheim)

• Node.js 18+ of een andere omgeving die HTTP-verzoeken kan doen

Stap 1: Uw API-sleutels verkrijgen

Meld u aan bij uw dashboard en ga naar de sectie "API-sleutels". Maak een nieuw sleutelpaar aan. U ontvangt:

• Publieke sleutel (pk_live_...): identificeert uw applicatie

• Geheime sleutel (sk_live_...): verifieert uw verzoeken (nooit blootstellen aan de clientzijde)

Stap 2: Eerste verzoek

Hier is een voorbeeld in JavaScript/TypeScript:

1
2
3
4
5
6
7
8
9

const response = await fetch(class="code-string">'https:class="code-comment">//companybelgium.be/api/companies/search?q=Proximus', {
  headers: {
    class="code-string">'X-API-Key': class="code-string">'pk_live_uw_publieke_sleutel',
    class="code-string">'X-API-Secret': class="code-string">'sk_live_uw_geheime_sleutel',
  },
});

const data = await response.json();
console.log(data.results);

Stap 3: Geavanceerd zoeken

De API ondersteunt verschillende zoektypen:

• Op naam: /api/companies/search?q=naam

• Op KBO-nummer: /api/companies/{id}

• Op adres: /api/companies/address?zipCode=1000

• Peppol-controle: /api/peppol/check?vatNumber=BE0123456789

Best practices

Conclusie

De integratie van de KBO/BCE API is eenvoudig en snel. In enkele minuten kunt u uw applicatie verrijken met officiële gegevens van Belgische bedrijven. Verdiep u verder met de Node.js en TypeScript-gids voor de KBO-API, de Python-tutorial met FastAPI, de gids voor het beveiligen van API-sleutels en de volledige BCE-endpoints-referentie.