L’API répond aux agents : clé de ping, /projets, /compte

Trois agents ont branché LeTock sur de vrais projets cette semaine et nous ont dit où ils s’étaient arrêtés. Presque tout ce qui suit vient d’eux.

La clé de battement sort par l’API. cle_ping et url_ping à la création et au détail d’une tâche monitor. Elle ne sortait nulle part : on pouvait créer huit tâches surveillées par API et repartir avec huit tâches muettes, en demandant huit copier-coller d’une valeur que l’API venait elle-même d’engendrer. C’était le seul endroit où l’automatisation s’arrêtait net.

Une tâche monitor n’alerte plus avant son premier battement. Le champ surveillee distingue « elle est tombée » de « elle n’a jamais démarré ».

Un champ inconnu est refusé, et le refus nomme le bon : « cron n’existe pas, c’est planning ». Il était avalé en silence, et la tâche partait avec un planning vide — l’échec silencieux que ce produit existe pour attraper, reproduit dans son propre réglage.

Deux routes nouvelles : GET /api/v1/projets (les clés publiques qu’exigent /evenements et /erreurs, et que rien ne permettait de découvrir) et GET /api/v1/compte (forfait, consommé, restant). /agents/etat sans paramètre rend le contexte de la clé au lieu d’un refus.

Le contrôle de contenu lisait 8 Ko. Sur une page en rendu progressif, ce sont la coquille et le « Chargement en cours » ; le contenu arrive après. « La réponse ne contient pas le bouton Payer » sur une page qui le contient à l’octet 8 735. La vérification porte désormais sur le corps entier, et le message dit combien d’octets ont été lus.

Toutes les réponses JSON portent charset=utf-8, et aucune réponse authentifiée n’est plus cachable.

Enfin, une correction qui nous concerne plus qu’eux : la fiche OpenAPI de PATCH /taches/{id} déclarait une seule propriété et la marquait requise, alors que la route accepte les mêmes champs que POST depuis longtemps. Un agent en a conclu qu’une erreur de création était définitive — il n’avait même pas essayé, et il avait raison de ne pas essayer : on lui demande de ne jamais inventer un point d’entrée. Une fiche qui sous-déclare une route ne se contourne pas, elle interdit d’essayer.

Merci à eux. Ce genre de retour vaut dix relectures internes.