Multi-tenant en white-label: de KBO-API integreren bij uw klanten

In het kort

De multi-tenant integratie van de KBO-API laat franchises, boekhoudnetwerken en resellers toe om Company Belgium onder hun eigen merk in te bedden: eigen landingspagina, gepersonaliseerde branding, eigen domein. De configuratie gebeurt in enkele uren via een self-service API, zonder herdeployment.

Multi-tenant is meer dan databasescheiding

Voor veel softwareleveranciers stopt "multi-tenant" bij databasescheiding. Nodig, maar ruim onvoldoende. Wanneer een franchisenemer, een accountantskantoor of een reseller uw platform gebruikt om zijn eigen klanten te bedienen, wil hij dat de ervaring zijn naam draagt, niet de uwe.

We leverden deze bouwsteen voor integrators die de Company Belgium-API in hun eigen product embedden.

Wanneer multi-tenant strategisch wordt

• Franchises — elk lokaal verkooppunt wil eigen etalage.

• Boekhoudnetwerken — fiduciaires die onze KBO-zoekresultaten doorverkopen aan klanten en op hun merk willen afstemmen.

• API-resellers — integrators die onze backend embedden en geen "Powered by Company Belgium" overal willen.

Wat een tenant regelt

Eigen header en shell

De componenten TenantHeader en TenantShell consumeren de config van de actuele tenant bij render. Logo, weergavenaam, navigatielinks, rechteritems — instelbaar zonder code te raken.

Eigen landingspagina

Een landing-motor laat toe een homepage samen te stellen uit herbruikbare blokken. Rendering is dynamisch: dezelfde publieke URL toont de landing van de tenant gedetecteerd via subdomein of pad.

Kleuren, typografie, logo

CSS-variabelen worden door de tenantconfig aangestuurd. Aanpassing in admin slaat onmiddellijk door.

Domein en subdomein

• Subpad — companybelgium.be/mijn-partner, instant.

• Eigen domein — mijn-partner.be, DNS + certificaten automatisch beheerd.

Self-service branding-API

1
2
3
4

# Tenantbranding ophalen
curl https://companybelgium.be/api/tenant/branding \
  -H "X-API-Key: pk_live_..." \
  -H "X-API-Secret: sk_live_..."

1
2
3
4
5

# Logo en primaire kleur aanpassen
curl -X PUT https://companybelgium.be/api/tenant/branding \
  -H "X-API-Key: pk_live_..." \
  -H "X-API-Secret: sk_live_..." \
  -d '{"logoUrl": "https://cdn.partner.be/logo.svg", "primaryColor": "#0066cc"}'

Beveiliging en isolatie

• Logische DB-isolatie — gevoelige entiteiten dragen verplichte tenantId, per request gecontroleerd.

• Sessie-scoping — gebruiker ingelogd op tenant ziet alleen die data.

• Logging — elke actie gelogd mét tenant.

Lopende cases

• Een boekhoudkantoor in Wallonië — eigen subdomein, KBO-zoekopdrachten op eigen naam.

• Een due diligence-netwerk — landing per kantoor, netwerkbreed dashboard bovenop.

• Een API-reseller — verkoopt door met eigen algemene voorwaarden. Wij blijven onzichtbaar.

Voor wie?

Als u een netwerk, franchise of resellerprogramma runt en overweegt "ons eigen portaal bouwen", stel de vraag: hoeveel tijd, hoeveel euro, hoeveel mensen? Deze bouwsteen levert dezelfde belofte in enkele uren setup. Bekijk ook ons partnerprogramma met automatische commissie en de API-beveiliging met sleutelbeheer.