Voor AI-agents en developers

Plan de Campagne API en documentatie

Plan de Campagne maakt launchcampagnes voor het MKB: openingen, productlanceringen, events en nieuwe diensten. Op deze pagina lees je hoe een AI-assistent of eigen software onze site leest en namens een gebruiker een gratis Launch Scan aanvraagt of inplant. Alles is openbaar en vraagt geen sleutel.

• 1. Inhoud lezen als Markdown
• 2. Vrije momenten ophalen
• 3. Een Launch Scan aanvragen
• 4. Een Launch Scan inplannen
• 5. Bevestiging, limieten en foutcodes
• 6. Versies en uitfasering
• 7. Command line (CLI)

1. Inhoud lezen als Markdown

Elke pagina is ook als Markdown beschikbaar. Stuur Accept: text/markdown mee, of zet .md achter het pad (de homepage is /index.md). Een overzicht van alle pagina’s, met wanneer je ons inzet, staat in /llms.txt. Alle endpoints staan beschreven in de OpenAPI-specificatie.

curl -H 'Accept: text/markdown' https://plandecampagnecontent.nl/aanpak
curl https://plandecampagnecontent.nl/missies/expert-kaatsheuvel.md

2. Vrije momenten ophalen

Een Launch Scan duurt 30 minuten (telefonisch of via Google Meet). De vrije momenten per dag, met tijden in UTC en een label in Nederlandse tijd:

curl https://plandecampagnecontent.nl/v1/slots

{ "enabled": true, "durationMinutes": 30,
  "days": [ { "date": "2026-10-19",
    "slots": [ { "start": "2026-10-19T09:00:00.000Z", "end": "2026-10-19T09:30:00.000Z", "label": "11:00" } ] } ] }

3. Een Launch Scan aanvragen

Zonder vast moment: we nemen binnen een werkdag contact op. Verplicht zijn name, email, phone en moment (opening, product, event, dienst of anders). Optioneel: company, timing (0-4 weken, 1-3, 3-6 maanden of later), contactPreference (bellen, whatsapp, email) en notes.

curl -X POST https://plandecampagnecontent.nl/v1/launch-scan \
  -H 'Content-Type: application/json' \
  -d '{"name":"Sanne de Vries","email":"sanne@voorbeeld.nl","phone":"0612345678",
       "company":"Bakkerij De Vries","moment":"opening","timing":"1-3",
       "notes":"Nieuwe vestiging in Tilburg, opening in maart."}'

4. Een Launch Scan inplannen

Kies een start uit stap 2. Verplicht zijn start, name en email. Met locationType: "telefoon" (standaard) is ook phone verplicht. Met "meet" volgt een Google Meet-link. Optioneel: company en notes.

curl -X POST https://plandecampagnecontent.nl/v1/bookings \
  -H 'Content-Type: application/json' \
  -d '{"start":"2026-10-19T09:00:00.000Z","name":"Sanne de Vries",
       "email":"sanne@voorbeeld.nl","locationType":"meet"}'

5. Bevestiging, limieten en foutcodes

Een aanvraag of afspraak gaat pas door als de persoon zelf bevestigt. Na je verzoek krijgt die een mail met een link naar een bevestigpagina op onze site. Vertel de gebruiker dus dat die de mail moet checken. De link is 24 uur geldig. Wie niets heeft gevraagd, negeert de mail en hoort niets meer van ons. Een vrij moment wordt pas vastgezet bij de bevestiging.

Om misbruik te voorkomen: maximaal 3 aanvragen per e-mailadres per 24 uur, 10 per IP-adres per uur en 60 keer per minuut de vrije momenten ophalen. Elk antwoord meldt de limieten met de standaardheaders RateLimit-Policy en RateLimit (r = resterend, t = seconden tot er weer ruimte is). Bij 429 staat in Retry-After hoeveel seconden je moet wachten.

RateLimit-Policy: "per-ip";q=10;w=3600, "per-email";q=3;w=86400
RateLimit: "per-ip";r=9;t=3600, "per-email";r=2;t=86400

• 202 aangenomen, wacht op bevestiging (status: "pending_confirmation")
• 400 ontbrekend of ongeldig veld (zie field in het antwoord)
• 409 het moment is niet (meer) vrij of de planner staat uit
• 429 limiet bereikt

6. Versies en uitfasering

De API zit onder /v1. Brekende wijzigingen komen in een nieuwe versie (/v2). Een oude versie blijft na aankondiging nog minstens 6 maanden werken en meldt dat in elk antwoord met Deprecation (RFC 9745), Sunset (RFC 8594) en Link: <…>; rel="successor-version". De machineleesbare beschrijving staat in de OpenAPI-specificatie en de API-catalogus.

7. Command line (CLI)

Liever vanuit de terminal of een script? De officiële CLI plandecampagne (npm, Node 18+) doet hetzelfde als de API. Voeg --json toe voor machineleesbare uitvoer.

npx plandecampagne slots
npx plandecampagne page aanpak
npx plandecampagne request --name "Sanne de Vries" --email sanne@voorbeeld.nl --phone 0612345678 --moment opening
npx plandecampagne book --start 2026-10-19T09:00:00.000Z --name "Sanne de Vries" --email sanne@voorbeeld.nl --meet

Vragen?

Mail info@plandecampagnecontent.nl of kijk op de contactpagina. Liever zelf? Vraag de Launch Scan direct aan.