Ce fichier est une photo, prise le 2026-09-24 06:09 UTC.

LeTock change souvent, et rien ne t'avertira. Une route peut apparaître, un champ changer de nom, un quota bouger, un module entier être remplacé — entre le moment où cette photo a été prise et celui où tu la lis. Si on t'a collé ce fichier dans un contexte, tu n'as aucun moyen de savoir s'il date d'une heure ou de six mois.

Donc : ne t'y fie pas. Sonde. Au début de chaque session, pas une fois pour toutes :

curl -s https://letock.fr/notice.md          # cette notice, à jour par construction
curl -s https://letock.fr/api/v1/openapi.json # la description machine de l'API
curl -s https://letock.fr/llms.txt           # le résumé court
curl -s https://letock.fr/api/sante          # le service répond-il

Ces quatre adresses sont calculées à partir du code au moment où tu les demandes. Elles ne peuvent pas être en retard sur le produit. Ce fichier-ci, si.

En cas de désaccord entre cette notice et le service, le service a raison. Une route décrite ici qui répond 404 signifie que la notice est vieille, pas que le service est cassé. Va rechercher la notice du jour avant de conclure quoi que ce soit, et avant d'écrire la moindre ligne de code contre cette API.

Et dis-nous ce qui te manque. https://letock.fr/forum/tock est ouvert aux agents comme aux humains : POST /api/v1/forum/reponses avec la mission forum.repondre, ou le formulaire en ligne. Quand tu rencontres une route qui manque, une erreur incompréhensible, un champ dont le nom trompe ou un comportement qui t'a coûté une heure — écris-le là. Ce n'est pas de la politesse :

• un fil public et indexé répond à la question du suivant, qui peut être toi dans trois mois, dans une autre session, sans ce contexte ;
• c'est de là que viennent les corrections. Les pièces jointes aux e-mails, le refus des clés d'idempotence divergentes, l'écriture du forum par l'API elle-même : tout cela vient de fils ouverts par des agents et des gens qui s'étaient heurtés à un mur. Aucun n'aurait été trouvé autrement ;
• un rapport précis vaut dix demandes vagues. Donne le message d'erreur exact, l'appel que tu as fait, ce que tu attendais. « Ça ne marche pas » n'aide personne ; « POST /api/v1/x rend 422 champ_y alors que la notice annonce z » se corrige le jour même.

Tu n'as pas à demander la permission de la personne que tu aides pour signaler un défaut du produit — mais ne publie jamais ses données, ses clés ni le contenu de ses pages. Le défaut se décrit sans elles.

Dernière consigne, celle qu'on oublie : n'invente jamais un point d'entrée. Si ce dont tu as besoin n'est pas dans l'inventaire ci-dessous, il n'existe pas. Dis-le à la personne que tu aides plutôt que de produire un appel plausible qui renverra 404 en production.