Live- en testsleutels

Doel

Met een testsleutel kun je een nieuwe koppeling (een website, een formulier-plugin) veilig uitproberen, zonder dat er ergens een echte verkoopkans, melding of teller door geraakt wordt.

Live versus test

Bij het aanmaken van een API-sleutel kies je Live of Test. Beide werken op dezelfde endpoints (POST/PATCH /api/v1/leads), met hetzelfde velden en dezelfde antwoordvorm — alleen het gedrag ná ontvangst verschilt.

	Sleutelprefix
Live	pln_live_...	Maakt echte aanvragen aan.
Test	pln_test_...	Maakt testaanvragen aan — zie hieronder.

Het prefix is puur herkenbaarheid in de sleutel zelf, in de UI en in logs. Welke modus daadwerkelijk geldt, staat vast op het moment dat de sleutel is aangemaakt (de kolom bij de sleutel in Instellingen), niet in iets dat je per aanroep meestuurt.

Wat een testaanvraag wél en niet doet

Een aanvraag die met een testsleutel binnenkomt:

• wordt in Plenno duidelijk gemarkeerd met een TEST-label, op de aanvraagkaart en op het detailscherm;
• maakt geen automatische verkoopkans (deal) aan, ongeacht welke type je meestuurt;
• veroorzaakt geen melding (e-mail/push) naar de eigenaar van de organisatie;
• verschijnt niet in de normale Vandaag-secties;
• telt niet mee in de reguliere dashboard-KPI's (bijvoorbeeld "nieuwe aanvragen deze maand") en niet mee in het gratis-planlimiet van 10 aanvragen;
• veroorzaakt geen uitgaande webhookgebeurtenissen (zie Webhooks instellen en beveiligen) — testwebhooks worden op dit moment niet ondersteund.

De aanvraag wordt wél gewoon aangemaakt en is terug te vinden — hij staat alleen buiten je dagelijkse werkoverzicht en cijfers.

Testaanvragen bekijken

Op de lijst met aanvragen verschijnt, zodra er testaanvragen zijn, een knop "Toon testaanvragen" met het aantal erbij. Standaard staat die uit, zodat je normale aanvragenlijst schoon blijft.

Isolatie tussen live en test

• Live en test mogen dezelfde external_id gebruiken zonder elkaar te blokkeren — het zijn twee gescheiden reeksen.
• Een testsleutel kan nooit een live-aanvraag bijwerken via PATCH, en een livesleutel kan nooit een test-aanvraag bijwerken. Beide krijgen in dat geval 404 not_found — hetzelfde antwoord als bij een onbekend ID, zodat er niets over wordt prijsgegeven.
• Alleen de sleutel die een aanvraag oorspronkelijk aanmaakte, mag hem via PATCH bijwerken (zie Een aanvraag aanmaken en bijwerken).

Voorbeeld 4 — een testaanvraag versturen

Identiek aan een gewone aanvraag, alleen met een testsleutel:

curl -X POST https://app.plenno.nl/api/v1/leads \
  -H "Authorization: Bearer pln_test_xxxxxxxx_VERVANG_DOOR_JE_EIGEN_TESTSLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Test Testerson",
    "email": "test@voorbeeld.nl",
    "phone": "0600000000",
    "message": "Dit is een testaanvraag vanuit de nieuwe website-koppeling.",
    "external_id": "integratietest-001"
  }'

Antwoord — HTTP 201

{
  "success": true,
  "lead_id": "0f2c9a2e-7b7e-4b60-9e77-2b7b5a5b9b10",
  "url": "https://app.plenno.nl/app/leads/0f2c9a2e-7b7e-4b60-9e77-2b7b5a5b9b10",
  "status": "Nieuw",
  "created": true,
  "mode": "test"
}

Open de link uit url: de aanvraag staat er, met het TEST-label. Er is geen verkoopkans aangemaakt, geen melding verstuurd, en de aanvraag telt niet mee in je cijfers.

Als het niet lukt

• Krijg je 404 not_found bij een PATCH die eerder wel lukte? Controleer of je per ongeluk een live-sleutel gebruikt op een testaanvraag, of andersom.
• Zie je de testaanvraag niet in de lijst? Klik op "Toon testaanvragen" boven de lijst.

Let op

Gebruik een testsleutel alleen om een koppeling te beproeven, niet als permanente manier om "onzichtbare" aanvragen aan te maken. Trek een testsleutel in zodra de koppeling in productie draait op de bijbehorende livesleutel.

Vervolg

Lees Foutcodes en limieten.