Comment ça marche, et sur quoi c’est construit

Un point de contrôle est un petit service placé entre un émetteur et un récepteur. Il ne modifie aucun des deux systèmes. Il contrôle, laisse passer ce qui est conforme, refuse le reste avec un motif, et consigne tout.

Un appel, du début à la fin

émetteur (A)                contrôle                      récepteur (B)
    |                           |                               |
    |  POST message  ---------> |                               |
    |                           |  lit le CSV ou le JSON        |
    |                           |  compare au format attendu    |
    |                           |                               |
    |                           |  conforme ? --- message ----> |
    |                           |  <------------ réponse ------ |
    |  <-- 200 + réponse de B - |                               |
    |                           |                               |
    |                           |  non conforme ? B n'est pas   |
    |  <--- 422 + motifs ------ |  appelé                       |
    |                           |  journal : ce qui est entré,  |
    |                           |  ce qui est sorti, pourquoi   |

Quand un contrôle entre deux systèmes vaut la peine

L’émetteur sait appeler une adresse, mais on ne peut pas lui apprendre les règles du récepteur.
Le récepteur attend un format, une taille ou des valeurs qui lui sont propres.
Aucun des deux ne peut être modifié : ce sont des produits d’éditeurs, ou ceux qui les ont écrits ne sont plus là.
L’émetteur a besoin de la réponse dans le même appel, pas dans un rapport du lendemain.
Quelqu’un doit pouvoir prouver ce qui s’est passé.

Construit sur Qu4zr

Ce site n’est pas un serveur que quelqu’un entretient. C’est un canevas de blocs sur Qu4zr : une adresse HTTP pour le contrôle, quelques courts blocs de JavaScript, une base de données intégrée pour le journal, et une tâche quotidienne qui supprime ce qui a expiré. Les pages que vous lisez sont des fichiers du même canevas.

Les mêmes briques font un point de contrôle pour vos propres systèmes :

Transmettre à un vrai récepteur. Le récepteur simulé est remplacé par un appel à votre API. Les identifiants restent dans un coffre et n’apparaissent ni dans le code ni dans les journaux.
Atteindre un système à l’intérieur de votre réseau. Un runner installé sur l’une de vos machines permet au contrôle d’interroger un ERP ou une base installés chez vous, sans ouvrir de port.
Transformer, pas seulement contrôler. Renommer des champs, convertir des dates, produire à partir d’un JSON le XML ou le fichier à largeur fixe que le récepteur attend.
Vérifier l’émetteur. Contrôler la signature d’un webhook ou une clé d’API avant tout le reste.

L’adresse est en ligne dès qu’elle est décrite, et chaque modification est versionnée. Découvrir Qu4zr.

Ce que ce site public ne prétend pas faire

Les points de contrôle publics ne transmettent rien, volontairement : un relais ouvert vers n’importe quelle adresse est un outil d’abus. Ils servent à tester un format, un webhook ou un fichier, et à voir l’idée fonctionner. Les limites et les durées de conservation sont sur la page Confidentialité.