Migratie v1 → v2
v2 breekt v1 niet — beide bestaan naast elkaar. Migreer endpoint per endpoint in uw eigen tempo.
Coëxistentie
v1-endpoints (`/api/companies/*`, `/api/establishments/*`) blijven onbeperkt beschikbaar. Uw API-sleutels en geheimen werken identiek op beide versies.
Routekaart
| v1 | v2 |
|---|---|
| GET /api/companies/{id} | GET /api/v2/enterprise/{num} |
| GET /api/companies/{id}/establishments | GET /api/v2/enterprise/{num}/establishments |
| GET /api/companies/{id}/financials | GET /api/v2/enterprise/{num}/financial |
| — | GET /api/v2/enterprise/{num}/activities |
| — | GET /api/v2/enterprise/{num}/address |
| — | GET /api/v2/enterprise/{num}/contact |
| — | GET /api/v2/enterprise/{num}/denominations |
| — | GET /api/v2/enterprise/{num}/roles |
| GET /api/establishments/{id} | GET /api/v2/establishment/{num} |
| — | GET /api/v2/naces?q=... |
| — | GET /api/v2/juridical-forms |
| — | GET /api/v2/denominations?q=... |
| — | GET /api/v2/vat/{vatNumber} |
| — | GET /api/v2/me |
| — | ALL /api/v2/webhook[s]/* |
Belangrijke wijzigingen
- URL-prefix wijzigt: `/api/companies/{id}` → `/api/v2/enterprise/{num}`.
- Sub-resources zijn nu aparte endpoints (`/activities`, `/contact`, etc.) in plaats van geneste velden.
- Het response-omhulsel `{success, data, timestamp}` blijft identiek.
Migratievoorbeeld
diff
# Avant (v1) - GET /api/companies/1033022383 + GET /api/v2/enterprise/1033022383 # Granularité v2 — fetch uniquement le contact + GET /api/v2/enterprise/1033022383/contact # Auth identique : mêmes headers X-API-Key + X-API-Secret