WaitlarkHelp

Aanmelden via de JSON API

Stuur aanmeldingen vanuit je eigen code en krijg het token voor vervolgvragen terug.

Je eigen formulier, app of flow kan mensen aanmelden met een POST en Accept: application/json:

const res = await fetch('https://api.waitlark.com/v1/p/pk_yourproject/join', {
  method: 'POST',
  body: new FormData(form),            // email, lang, your questions, cf-turnstile-response
  headers: { Accept: 'application/json' },
});
const out = await res.json();           // { ok: true, token: "…", position: 142 }

Waitlark neemt alleen verzoeken aan van de sites op de lijst van je project, en ze moeten het token van de botcheck meesturen.

Het antwoord

  • ok: true met een token en een position. Een tweede aanmelding met hetzelfde adres krijgt een antwoord dat er precies hetzelfde uitziet.
  • ok: false met een error-code. Zie Foutcodes.

Vervolgvragen

Met het token sla je de antwoorden op van de vragen die je na de aanmelding stelt:

await fetch('https://api.waitlark.com/v1/p/pk_yourproject/profile', {
  method: 'POST',
  body: new URLSearchParams({ token, monthly_orders: '100_1k' }),
  headers: { Accept: 'application/json' },
});
  • Stuur alleen de vragen die beantwoord zijn. De andere blijven zoals ze waren.
  • Stuur een vraag met een lege waarde mee om een eerder antwoord te wissen.
  • Antwoorden zijn tot zeven dagen na de aanmelding te wijzigen.
  • Waitlark antwoordt altijd met { "ok": true }, zodat niemand met een verkeerd token iets te weten kan komen.

Limieten

  • 20 verzoeken per minuut per bezoeker en project.
  • Een body van hooguit 32 KB per verzoek, met een Content-Length-header (browsers sturen die altijd mee).

Bijgewerkt 23 oktober 2026