Problemen oplossen bij aanvragen

Een fout lezen

Elke weigering bevat twee dingen: een code voor het type fout, en een details.reason voor de specifieke oorzaak. Vertak op de code; lees de reden om te weten wat je moet oplossen. Waar het helpt, noemt details ook het betreffende field, de sleutels die geaccepteerd zouden zijn, of de optiesleutels die een keuzevraag aanneemt.

De aanvraagmethoden gebruiken vier codes: VALIDATION_ERROR (de aanroep klopte niet), CONFLICT (de aanvraag staat in de verkeerde toestand, of een idempotency-sleutel is hergebruikt), NOT_FOUND, en UPGRADE_REQUIRED (een abonnementsgrens of het maandelijkse quotum). Te snel aanroepen geeft in plaats daarvan RATE_LIMITED terug, met retryAfterMs — zie de snelheidslimiet.

{
  "ok": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "No field with key \"company\".",
    "details": { "reason": "UNKNOWN_FIELD_KEY", "field": "prefill.company", "validKeys": ["company_name", "company_size"] }
  }
}

Redenen die je kunt tegenkomen

De aanroep goed krijgen

Handelen op een bestaande aanvraag

De uitnodiging is nooit aangekomen

Open de aanvraag op de pagina Aanvragen en lees de tijdlijn. De eerste uitnodigingsregel vertelt je in welk geval je zit.

Uitnodigingen en herinneringen delen een budget van tien e-mails per dag per formulier en ontvangeradres, en één aanvraag mailt zijn ontvanger nooit meer dan negen keer in zijn hele bestaan — één uitnodiging en tot acht herinneringen.

De callback is nooit binnengekomen

De sectie Callback in het aanvraagpaneel toont de URL en de uitkomst. Callback mislukt na N pogingen betekent dat formbase het heeft geprobeerd en heeft opgegeven — acht pogingen over ongeveer vier uur.

1. Controleer de URL. Hij wordt getoond in het paneel. De resume-URL van een workflowtool hoort bij één run, en een run die is verwijderd of opnieuw is aangemaakt, reageert daar niet meer op.

2. Controleer wat je endpoint heeft teruggegeven. Alles buiten 2xx is een mislukking. Een 4xx anders dan 408 of 429 stopt de pogingen onmiddellijk — formbase leest dat als “je endpoint heeft dit geweigerd”, en identieke bytes opnieuw sturen kan daar niets aan veranderen.

3. Herstel de ontvanger, druk dan op Opnieuw afspelen. Dezelfde payload gaat opnieuw uit met hetzelfde gebeurtenis-id, dus een ontvanger die dedupliceert is veilig.

Andere dingen waar mensen tegenaan lopen

• De ontvanger zegt dat de link een melding toont, niet het formulier. De aanvraag is definitief — voltooid, verlopen, of geannuleerd. Dat is de uitkomstpagina. Maak een nieuwe aanvraag als ze nog een keer moeten.

• Een automatisering matcht niet meer na een bewerking — een antwoord ontbrak in de callback, of requests.create begon een sleutel te weigeren met UNKNOWN_FIELD_KEY. Een gepubliceerde veldsleutel is verdwenen: iemand heeft hem herschreven, of de vraag verwijderd en er een nieuwe voor in de plaats gezet. Hertitelen is veilig; beide andere niet. Typ de oude sleutel op het veld (sleutelicoon in de werkbalk → Sleutels) en publiceer opnieuw. Publiceren waarschuwt hiervoor voordat het gebeurt — zie Wanneer een gepubliceerde sleutel op het punt staat te verdwijnen.

• Vooraf invullen voor een bestandsupload of een handtekening wordt geweigerd. Die kunnen niet door een aanroeper worden aangeleverd — fields.list markeert ze met prefillable: false.

• Er verschenen twee aanvragen voor één workflowrun. De run is opnieuw geprobeerd zonder idempotencyKey. Geef de uitvoerings-id op als sleutel.