API-integraties: sleutels voor externe systemen

API-sleutels zijn de toegangscode voor externe systemen om met Tesoro te praten, uw website, integraties, het Client Portal. Behandel ze als wachtwoord.

Wanneer gebruikt u dit?

Eerste API-sleutel aanmaken voor een ontwikkelaar
Bestaande sleutel roteren na vermoeden van lek
Sleutel zoeken voor Client Portal-link

Wat is een API-sleutel?

Lange willekeurige string die bij elke API-aanroep wordt meegestuurd. Tesoro herkent welk bedrijf erbij hoort + welke rechten gelden.

Gebruikt door:

Uw eigen website om woningfeeds op te halen
Externe integraties (CRM-bridges, lead-formulieren, websitewidgets)
Client Portal (URL-parameter id=<api-sleutel>)
Webhooks (om uitgaande hooks te authenticeren)
Open API (voor scripts en automation)

Een nieuwe sleutel genereren

Settings → My Company → API Keys.
Klik Generate New Key.
Geef sleutel een herkenbare naam (bv. “Website widget”).
Klik Generate. Sleutel verschijnt, kopieer direct.

Sleutels beheren

Actie	Wat
Lijst	Alle sleutels met naam + aanmaakdatum (sleutel zelf niet zichtbaar na aanmaak)
Rename	Naam wijzigen
Revoke	Permanent intrekken; gebruikers van die sleutel verliezen direct toegang

Veiligheid

Behandel als wachtwoord. Nooit in publieke code committen.
Bij vermoeden van lek: revoke + nieuwe genereren. Direct.
Eén sleutel per integratie is aanbevolen, bij compromittering kunt u zonder downtime de relevante sleutel intrekken.
Logs: API-toegang wordt gelogd. Vraag Tesoro-team om verdachte activiteit te controleren.

Open API documentatie

Voor ontwikkelaars: tesoro-open-api documentatie via uw Tesoro-contactpersoon. Endpoints voor woningen, contacten, leads, deals, activiteiten.

Volgende stap

Webhooks Real-time events naar externe systemen sturen.