1. Arbeitsbereich und Schlüssel erstellen
Onboarding abschließen, Tarif wählen, E-Mail bestätigen und API-Schlüssel erstellen. Bewahren Sie das bei der Erstellung angezeigte Geheimnis sicher auf.
2. Serveranfrage senden
Setzen Sie COMPANYAPI_KEY auf dem Server. Suchen Sie mit X-Api-Key nach Namen. Dieses Beispiel liefert eine Liste möglicher Treffer.
curl --get 'https://api.companyapi.be/companies' \
--data-urlencode 'name=Colruyt' \
--data-urlencode 'limit=5' \
--header "X-Api-Key: $COMPANYAPI_KEY"3. Details abrufen
Wählen Sie eine Unternehmensnummer und rufen Sie verfügbare Adressen, Kontakte und Aktivitäten erweitert ab. Die Basisabfrage liefert Identität und rechtlichen Status.
curl 'https://api.companyapi.be/companies/0801523965/extended' \
--header "X-Api-Key: $COMPANYAPI_KEY"4. Antworten behandeln
Unterscheiden Sie 400 Eingabe, 401 Authentifizierung, 404 nicht gefunden und 429 Limit. Keine Schlüssel im Browser oder in Protokollen offenlegen.
Beispielantwort
{
"enterpriseNumber": "0801.523.965",
"vatNumber": "BE0801.523.965",
"name": "Nyffels",
"status": { "code": "AC", "descriptions": {} },
"juridicalSituation": { "code": "000", "descriptions": {} },
"typeOfEnterprise": { "code": "2", "descriptions": {} },
"juridicalForm": null,
"juridicalFormCAC": null,
"startDate": "2023-05-01"
}Beispieldaten, keine Live-Abfrage. Datums- und Feldwerte dienen der Illustration.
