Dépannage des demandes

Lire une erreur

Chaque refus porte deux choses : un code pour le type d’échec, et un details.reason pour la cause précise. Testez le code ; lisez la raison pour savoir quoi corriger. Quand c’est utile, details nomme aussi le field fautif, les clés qui auraient été acceptées, ou les clés d’option acceptées par une question à choix.

Les méthodes de demande utilisent quatre codes : VALIDATION_ERROR (l’appel était incorrect), CONFLICT (la demande est dans le mauvais état, ou une clé d’idempotence a été réutilisée), NOT_FOUND, et UPGRADE_REQUIRED (une restriction de plan ou l’allocation mensuelle). Appeler trop vite renvoie RATE_LIMITED à la place, avec retryAfterMs — voir la limite de débit.

{
  "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"] }
  }
}

Raisons que vous pourriez rencontrer

Bien faire l’appel

Agir sur une demande existante

L’invitation n’est jamais arrivée

Ouvrez la demande dans la page Demandes et lisez la chronologie. La première ligne d’invitation vous indique dans quel cas vous êtes.

Les invitations et les rappels partagent un budget de dix e-mails par jour, par formulaire et par adresse de destinataire, et une demande n’envoie jamais plus de neuf e-mails à son destinataire au cours de sa vie — une invitation et jusqu’à huit rappels.

Le callback n’a jamais abouti

La section Callback du tiroir de la demande montre l’URL et le résultat. Callback échoué après N tentatives signifie que formbase a essayé et a abandonné — huit tentatives sur environ quatre heures.

1. Vérifiez l’URL. Elle est affichée dans le tiroir. L’URL de reprise d’un outil de workflow appartient à une seule exécution, et une exécution supprimée ou recréée ne répond plus dessus.

2. Vérifiez ce qu’a renvoyé votre point de terminaison. Tout ce qui sort de 2xx est un échec. Un 4xx autre que 408 ou 429 arrête immédiatement les nouvelles tentatives — formbase le lit comme « votre point de terminaison a rejeté ceci », et renvoyer les mêmes octets ne peut rien y changer.

3. Corrigez le récepteur, puis appuyez sur Rejouer. La même charge utile repart avec le même id d’événement, donc un récepteur qui déduplique ne risque rien.

Autres situations rencontrées

• Le destinataire dit que le lien affiche un avis, pas le formulaire. La demande est définitive — terminée, expirée, ou annulée. C’est la page de résultat. Créez une nouvelle demande s’il a besoin d’une nouvelle tentative.

• Une automatisation a cessé de correspondre après une modification — une réponse a disparu du callback, ou requests.create a commencé à refuser une clé avec UNKNOWN_FIELD_KEY. Une clé de champ publiée a disparu : quelqu’un l’a retapée, ou a supprimé la question et en a ajouté une nouvelle à sa place. Changer le titre est sûr ; aucun des deux autres cas ne l’est. Saisissez l’ancienne clé sur le champ (icône clé de la barre d’outils → Clés) et publiez à nouveau. La publication avertit avant que cela n’arrive — voir Quand une clé publiée est sur le point de disparaître.

• Le préremplissage d’un téléversement de fichier ou d’une signature est refusé. Ceux-ci ne peuvent pas être fournis par un appelant — fields.list les marque prefillable: false.

• Deux demandes sont apparues pour une même exécution de workflow. L’exécution a été retentée sans idempotencyKey. Passez l’id d’exécution comme clé.