payload/gate English

Un point de contrôle entre deux systèmes

Créez un point de contrôle, obtenez une adresse, et envoyez vos messages à travers. Chaque appel est contrôlé selon votre format et reçoit sa réponse tout de suite : accepté, ou refusé avec le motif exact. Chaque échange est gardé dans un journal.

Chargement de l’outil…

Ce que l’émetteur reçoit en retour

La réponse arrive dans le même appel, donc le système émetteur peut agir : réessayer, alerter quelqu’un, ou afficher le motif à un utilisateur. Les messages de motif sont rédigés dans la langue choisie à la création.

HTTP 200
{
  "accepted": true,
  "version": 3,
  "records": 1,
  "target": { "simulated": true, "status": 201, "body": { "id": "rcv_4f1c9a02b7e3", "stored": 1 } }
}
HTTP 422
{
  "accepted": false,
  "version": 3,
  "records": 2,
  "errorCount": 1,
  "errors": [
    { "row": 2, "path": "lines[1].label", "rule": "maxLength", "limit": 30, "actual": 50,
      "message": "\"lines[1].label\" has 50 characters, the maximum is 30" }
  ],
  "target": null
}

Des versions sans surprise

Quand le format doit changer, modifiez-le dans le tableau de bord. Avant l’enregistrement, le point de contrôle liste les changements, marque ceux qui cassent, et rejoue les derniers messages acceptés de son journal contre la nouvelle version : « 4 des 31 derniers messages acceptés seraient refusés ». Vous savez qui prévenir avant le changement, pas après.

Limites et confidentialité, sans détour

  • Le récepteur placé derrière le contrôle est simulé. La transmission vers un système à vous n’est pas ouverte sur ce site public.
  • Un message fait 64 Ko au plus. Un point de contrôle accepte 120 messages par heure.
  • Un appel contrôle environ 200 lignes CSV de cinq colonnes. Un message plus gros reçoit une réponse partielle qui indique combien d’enregistrements ont été contrôlés : envoyez les gros fichiers par lots.
  • Le journal garde les 100 derniers messages pendant 7 jours, et les 8 000 premiers caractères de chacun.
  • Un point de contrôle qui ne reçoit rien pendant 30 jours est supprimé.
  • Toute personne qui connaît l’adresse peut y envoyer un message. Seul le lien privé ouvre le journal.
  • N’envoyez ni numéros de carte, ni données de santé, ni secrets : c’est un outil de test.

Le détail est sur la page Confidentialité. Pour placer un contrôle de ce type devant un vrai système, voir Fonctionnement.

Questions

Faut-il un compte ?
Non. La création d’un point de contrôle vous donne un lien privé. Ce lien est la seule clé de son tableau de bord : conservez-le.
Peut-on tester un webhook ?
Oui. Faites pointer le webhook vers l’adresse de contrôle : chaque envoi est contrôlé selon votre format et apparaît dans le journal, avec le motif en cas de refus.
Quels types de contenu sont acceptés ?
Le JSON (un objet ou un tableau d’objets) et le CSV. Le format est lu dans l’en-tête Content-Type, ou deviné d’après le premier caractère.
Puis-je partager le format avec l’autre équipe ?
Oui. Chaque point de contrôle a une page publique en lecture seule pour son format, et le même format en JSON.