Getypeerde productlaag
Werk met Bedrijfsbron-contracten voor resolve, enrichment en geodata in plaats van elke upstream provider afzonderlijk te koppelen.
Bedrijfsbron voor developers
Bouw op stabiele productcontracten, niet op losse providerresponses.
Gebruik de workspace-API voor bedrijfsresolutie, duurzame enrichment en geodata. Broncredentials blijven achter FastAPI; je applicatie verwerkt expliciete statussen, provenance en reviewgevallen.
Bron per voorstel Review bij twijfel Origineel blijft bewaard
Waar dit bij helpt
Maak een databesluit controleerbaar vóór je het toepast.
Server-side secrets
Alle workspace- en providerkeys blijven buiten clientbundels; browsercode praat alleen met je eigen server of een veilige sessielaag.
Fouten blijven betekenisvol
Verwerk matchstatus, configuratiefouten, rate limits, reviewstatus en provenance als afzonderlijke producttoestanden.
Werkbare route
Van eerste signaal tot veilig resultaat.
- 01
Maak een serverintegratie
Bewaar de workspace-key zonder publieke frontendprefix en stuur hem alleen vanaf een vertrouwde runtime.
- 02
Valideer één contract
Start met resolve of geocode, controleer de volledige responsevorm en bouw alle foutstatussen in.
- 03
Voeg duurzame verwerking toe
Gebruik idempotente enrichmentjobs of CSV-repair wanneer resultaten, evidence en review bewaard moeten blijven.
- 04
Meet vóór opschaling
Test met toegestane records en controleer coverage, ambiguïteit, providerbeschikbaarheid en reviewvolume.
Synthetisch voorbeeld · geen klantdata
Een server-side fetch zonder sleutel in de browser.
Dit synthetische fragment laat de integratiegrens zien. Het bevat geen echte key en geen vooraf ingevulde API-response.
record is een placeholder en de env-naam bevat geen secret. Een echte uitkomst wordt uitsluitend uit response.json() gelezen.
Servercode · synthetische invoer
const response = await fetch(
"https://api.bedrijfsbron.nl/v1/companies/resolve",
{
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": process.env.BEDRIJFSDATA_API_KEY!,
},
body: JSON.stringify({ record }),
},
);Veilige afhandeling · geen voorbeeldresponse
if (!response.ok) {
throw new Error(`Bedrijfsbron: ${response.status}`);
}
const result: ResolveResponse = await response.json();
// Verwerk verified, probable, ambiguous en unmatched
// als afzonderlijke toestanden.Belangrijkste ingangen
Begin bij de stabiele productroutes. De ruwe bronroutes zijn uitsluitend bedoeld voor beheerde diagnose en niet als publiek integratiecontract.
- Company resolve en enrichment
- CSV-repair en review
- Geocode, route, matrix en isochrone
Productiecontrole
Een succesvolle typecheck bewijst nog geen bronbeschikbaarheid. Test foutpaden en providerstatus met gecontroleerde fixtures en optionele server-side probes.
- Geen secrets in logs
- Idempotency voor jobs
- Attributie bij geodata
Veelgestelde vragen
Eerst weten wat er precies gebeurt.
Kan ik Bedrijfsbron rechtstreeks vanuit een browser aanroepen?
Plaats geen workspace-key in browsercode. Gebruik een eigen serverroute of de beveiligde app-sessie en geef alleen noodzakelijke responsevelden door.
Zijn de ruwe bronroutes een stabiel productcontract?
Nee. Routes onder /v1/source-data zijn admin-only voor diagnose. Integraties horen de workspace-beveiligde productroutes te gebruiken.
Waar vind ik request- en responsevelden?
Gebruik de actuele OpenAPI-documentatie en de getypeerde API-client. De quickstart toont daarnaast de minimale veilige resolveflow.
Begin met echte input
Bespreek je dataset Toets Bedrijfsbron eerst op een afgebakende dataset.
Beschrijf je bronbestand, gewenste velden en beslisregels. Dan kan de pilot worden ingericht zonder directe writeback naar je ERP of CRM.