{
  "openapi": "3.1.0",
  "info": {
    "title": "API de Manicou",
    "version": "1.0.0-brouillon",
    "description": "Le contrat de l'API de Manicou (pièce C4 de docs/CONSTRUCTION.md). Il fait foi pour l'espace client, le site public, les recettes des sites et les intégrations. Chaque opération nomme, dans `x-ecrans`, les écrans de docs/ECRANS.md qui s'en servent.\n\n**Conventions**\n- Noms de champs en français, sans accent ; dates en ISO 8601, en UTC.\n- Identifiants opaques, tirés au hasard et préfixés par leur genre (`snd_` pour une sonde, `dom_` pour un domaine…) : on ne peut pas les deviner.\n- Une ressource d'un autre compte répond `404`, jamais `403` : on ne peut pas savoir qu'elle existe.\n- Listes longues : `elements`, puis `suivant`, le curseur de la page suivante ou `null`, à renvoyer dans `apres`.\n- Erreurs : `application/problem+json` (RFC 9457), avec un `code` stable et, pour un champ refusé, `champs`.\n- Toute entrée refuse les champs inconnus.\n\n**Accès**\n- `session` : le cookie posé à la connexion, `HttpOnly`, `Secure`, `SameSite=Strict`. Une requête qui écrit doit aussi porter l'en-tête `Origin` de l'espace client.\n- `cleApi` : `Authorization: Bearer <clé>`. Une clé ne sert qu'à son compte ; une clé « lecture » ne fait que lire. La session seule gère les clés, les membres, l'abonnement et le compte : une clé volée ne peut ni en créer d'autres, ni fermer le compte.\n- Les routes publiques (`security: []`) sont bornées par adresse IP et, pour les formulaires, par Turnstile.\n\n**Le texte des sources** (titres, résumés des failles) est une donnée : il s'affiche en texte, jamais en HTML."
  },
  "servers": [{ "url": "/api/v1" }],
  "security": [{ "session": [] }, { "cleApi": [] }],
  "tags": [
    { "name": "Public", "description": "Le site public : test gratuit, état des sources, recettes, pages de statut." },
    { "name": "Session", "description": "Connexion par lien e-mail ou clé d'accès, et choix du compte." },
    { "name": "Sondes", "description": "Les adresses surveillées, leurs mesures, leur stack et leur protection." },
    { "name": "Failles", "description": "Les failles qui touchent le compte, et le bouton d'urgence." },
    { "name": "Domaines", "description": "Les domaines prouvés : la condition des failles nommées et des ordres." },
    { "name": "Alertes", "description": "Politiques par sévérité, canaux, journal." },
    { "name": "Pages de statut" },
    { "name": "Réglages", "description": "Équipe, clés d'API, abonnement, compte. La session seule y accède." },
    { "name": "Sites", "description": "Ce que lisent et envoient les recettes posées chez les sites clients." },
    { "name": "Entrées", "description": "Les messages signés de GitHub et du marchand." }
  ],
  "paths": {
    "/test": {
      "post": {
        "operationId": "creerTest",
        "summary": "Lancer le test gratuit d'une adresse",
        "tags": ["Public"],
        "x-ecrans": ["S01", "S02"],
        "security": [],
        "description": "Un même site, son nom d'hôte, se teste une fois par dix minutes. Un autre visiteur de la même origine (schéma, nom et port) reçoit ce test, sans son `jeton`, en lecture seule ; sous une autre origine, le site vient d'être testé (409). Trois cents passages en dix minutes pour tout le service, versions données comprises, et trente pour un même réseau, un /24 en IPv4 ou un /48 en IPv6.",
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DemandeTest" } } } },
        "responses": {
          "202": { "description": "Test lancé ; son résultat se lit par son identifiant. Son `jeton` seulement pour qui le crée.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Test" } } } },
          "409": { "description": "Le même site vient d'être testé sous une autre origine, un autre schéma ou un autre port (`code` : `deja_teste`), sans dire laquelle ; `retry-after` dit dans combien de secondes il pourra l'être.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/test/{test}": {
      "get": {
        "operationId": "lireTest",
        "summary": "Lire le résultat d'un test gratuit",
        "tags": ["Public"],
        "x-ecrans": ["S02"],
        "security": [],
        "parameters": [{ "$ref": "#/components/parameters/Test" }],
        "responses": {
          "200": { "description": "Le test.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Test" } } } },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/test/{test}/versions": {
      "post": {
        "operationId": "preciserTest",
        "summary": "Donner au test gratuit la version qu'une page ne montre pas",
        "description": "Pour un logiciel que le test a lu sans version, ou dont la version a déjà été donnée : le test se refait dans la file avec elle, et ses failles se comptent, toujours sans leur nom. Par le seul visiteur qui a lancé le test, son `jeton` à l'appui. Trois fois par test au plus, sous la même limite par adresse IP, le même plafond qu'un test et la part du réseau qui les donne. Un test où des versions ont été données ne se rend pas à un autre visiteur de la même origine.",
        "tags": ["Public"],
        "x-ecrans": ["S02"],
        "security": [],
        "parameters": [{ "$ref": "#/components/parameters/Test" }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["versions", "jeton"],
                "additionalProperties": false,
                "properties": {
                  "versions": { "type": "object", "minProperties": 1, "maxProperties": 30, "description": "Le nom du logiciel, tel que le test le donne, et sa version : { \"wordpress\": \"6.4.2\" }.", "additionalProperties": { "type": "string", "pattern": "^[0-9][0-9A-Za-z.+_-]{0,39}$" } },
                  "jeton": { "type": "string", "maxLength": 100, "description": "Le jeton que creerTest a rendu à qui a créé le test." }
                }
              }
            }
          }
        },
        "responses": {
          "202": { "description": "Le test, qui se refait ; son résultat se lit par son identifiant.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Test" } } } },
          "403": { "description": "Sans le jeton de ce test, ou avec un autre (`code` : `createur_seul`) : il a été lancé par un autre visiteur.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "description": "Le test n'est pas fini, ou ses versions ont déjà été données trois fois (`code` : `precisions_epuisees`).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/public/failles": {
      "get": {
        "operationId": "listerFaillesPubliques",
        "summary": "Lister les failles majeures récentes",
        "description": "Les failles exploitées ou critiques des 90 derniers jours dont les sources donnent des versions touchées, 30 au plus, les plus récentes d'abord. Rien d'aucun compte. Gardé cinq minutes dans le cache.",
        "tags": ["Public"],
        "x-ecrans": ["S12"],
        "security": [],
        "responses": {
          "200": { "description": "Les failles.", "content": { "application/json": { "schema": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/FaillePublique" } } } } } } }
        }
      }
    },
    "/public/failles/{faille}": {
      "get": {
        "operationId": "lireFaillePublique",
        "summary": "Lire la fiche d'une faille majeure",
        "description": "Par l'un de ses identifiants (CVE, GHSA), sans tenir compte de la casse. Ses versions touchées, son correctif et ses sources, avec leur lien et leur licence, sans leur texte. Une faille qui n'est ni exploitée ni critique, ou sans version touchée, répond 404 comme un identifiant inconnu. Gardé cinq minutes dans le cache ; la limite par adresse IP.",
        "tags": ["Public"],
        "x-ecrans": ["S13"],
        "security": [],
        "parameters": [{ "name": "faille", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{2,63}$" } }],
        "responses": {
          "200": { "description": "La fiche.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FicheFaille" } } } },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sources": {
      "get": {
        "operationId": "lireSources",
        "summary": "Lire l'état des sources de la veille",
        "description": "S08, et la pastille de l'en-tête de l'espace client. La lecture la plus récente fait « Sources lues à 16:30 », sous « Rien à traiter » (A02).",
        "tags": ["Public"],
        "x-ecrans": ["S08", "A02", "A05", "A09", "A10", "A12"],
        "security": [],
        "responses": {
          "200": { "description": "L'heure de la dernière lecture de chaque source.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EtatSources" } } } }
        }
      }
    },
    "/lancement": {
      "get": {
        "operationId": "lireLancement",
        "summary": "Lire les places de l'offre de lancement",
        "description": "La barre de l'offre de lancement, sur l'accueil et les tarifs (S01, S03) : les 100 premiers clients paient leur formule un tiers du prix, à vie, tant qu'ils la gardent (docs/PLAN.md §9). Ouverte au site public, sans cookie ; gardée une minute. Toutes les places prises, le site retire le bloc. Une place compte dès qu'un paiement au tiers du prix s'ouvre, et le reste 10 minutes au plus s'il n'est pas payé.",
        "tags": ["Public"],
        "x-ecrans": ["S01", "S03"],
        "security": [],
        "responses": {
          "200": { "description": "Les places, et combien sont prises.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lancement" } } } }
        }
      }
    },
    "/recettes": {
      "get": {
        "operationId": "listerRecettes",
        "summary": "Lister les recettes de protection",
        "tags": ["Public"],
        "x-ecrans": ["A12"],
        "security": [],
        "responses": {
          "200": { "description": "Les recettes, plateforme par plateforme.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListeRecettes" } } } }
        }
      }
    },
    "/public/pages/{nom}": {
      "get": {
        "operationId": "lirePagePublique",
        "summary": "Lire une page de statut publique",
        "description": "Sans connexion. Une page privée, inconnue ou d'un compte fermé répond 404, sans dire laquelle. Gardée une minute dans le cache : l'état a au plus une minute de retard. Rien de privé n'en sort : ni adresse, ni identifiant, ni réglage, ni faille.",
        "tags": ["Public"],
        "x-ecrans": ["P01"],
        "security": [],
        "parameters": [{ "$ref": "#/components/parameters/NomPage" }],
        "responses": {
          "200": { "description": "Ce que la page montre, sans rien de privé.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PagePublique" } } } },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/public/pages/{nom}/logo": {
      "get": {
        "operationId": "lireLogoPublic",
        "summary": "Lire le logo d'une page de statut publique",
        "description": "Gardée une minute dans le cache de Cloudflare. Ce que le cache n'a pas se lit sous une limite de soixante requêtes par minute et par adresse IP, au-delà 429.",
        "tags": ["Public"],
        "x-ecrans": ["P01"],
        "security": [],
        "parameters": [{ "$ref": "#/components/parameters/NomPage" }],
        "responses": {
          "200": { "description": "L'image, gardée un jour : son adresse change avec elle.", "content": { "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/jpeg": { "schema": { "type": "string", "format": "binary" } }, "image/webp": { "schema": { "type": "string", "format": "binary" } } } },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/pages/{page}/logo": {
      "parameters": [{ "$ref": "#/components/parameters/Page" }],
      "get": {
        "operationId": "lireLogo",
        "summary": "Lire le logo d'une page de statut",
        "description": "Pour l'aperçu d'A15, même d'une page privée.",
        "tags": ["Pages de statut"],
        "x-ecrans": ["A15"],
        "responses": {
          "200": { "description": "L'image.", "content": { "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/jpeg": { "schema": { "type": "string", "format": "binary" } }, "image/webp": { "schema": { "type": "string", "format": "binary" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      },
      "put": {
        "operationId": "poserLogo",
        "summary": "Poser le logo d'une page de statut",
        "description": "L'image même, en corps : PNG, JPEG ou WebP, 256 Ko au plus. Jamais un SVG. Son type se lit dans ses premiers octets. Elle remplace la précédente, et la même image qu'avant ne s'écrit pas. Six logos par minute et par compte au plus, au-delà 429.",
        "tags": ["Pages de statut"],
        "x-ecrans": ["A15"],
        "requestBody": { "required": true, "content": { "image/png": { "schema": { "type": "string", "format": "binary" } }, "image/jpeg": { "schema": { "type": "string", "format": "binary" } }, "image/webp": { "schema": { "type": "string", "format": "binary" } } } },
        "responses": {
          "200": { "description": "La page.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageStatut" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      },
      "delete": {
        "operationId": "retirerLogo",
        "summary": "Retirer le logo d'une page de statut",
        "tags": ["Pages de statut"],
        "x-ecrans": ["A15"],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sessions": {
      "get": {
        "operationId": "listerSessions",
        "summary": "Lister les sessions ouvertes de la personne connectée",
        "tags": ["Session"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "La session courante d'abord, puis la plus récemment vue.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListeSessions" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      }
    },
    "/sessions/{session}": {
      "parameters": [{ "$ref": "#/components/parameters/Session" }],
      "delete": {
        "operationId": "fermerSession",
        "summary": "Déconnecter une session",
        "description": "Seulement une session de la personne connectée.",
        "tags": ["Session"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/session/lien": {
      "post": {
        "operationId": "demanderLien",
        "summary": "Recevoir un lien de connexion par e-mail",
        "description": "Répond toujours `202`, que l'adresse ait un compte ou non : on ne peut pas savoir qui est inscrit. Le premier lien validé crée le compte. La réponse pose le cookie `__Host-manicou_lien`, qui lie le lien à ce navigateur ; le lien porte son jeton après `#`. Au plus 3 liens par quart d'heure et 10 par jour pour une même boîte, comptés sans la sous-adresse qui suit « + » ni les points chez Gmail, et 60 par heure vers les boîtes sans compte d'un même domaine : au-delà, rien ne part, et la réponse reste `202`. L'adresse n'a qu'une partie locale simple, des lettres et des chiffres avec « . », « _ », « - », « + » ou « ' », sans guillemets ni virgule, sinon 422.",
        "tags": ["Session"],
        "x-ecrans": ["S10"],
        "security": [],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DemandeLien" } } } },
        "responses": {
          "202": { "$ref": "#/components/responses/Accepte" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/session/lien/valider": {
      "post": {
        "operationId": "validerLien",
        "summary": "Se connecter avec le jeton du lien",
        "description": "Le lien de l'e-mail ouvre une page de l'espace client, qui lit le jeton après `#` et l'envoie ici. Sans le cookie `__Host-manicou_lien` du navigateur qui a demandé le lien, la réponse est `409` avec l'adresse du lien, et rien n'est consommé : la personne la voit et confirme (`confirme: true`). Un lien envoyé par un tiers, ou ouvert par un filtre de messagerie, ne connecte donc personne à son insu.",
        "tags": ["Session"],
        "x-ecrans": ["S10"],
        "security": [],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JetonDeLien" } } } },
        "responses": {
          "204": { "$ref": "#/components/responses/SessionOuverte" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "409": { "description": "Le lien vient d'un autre navigateur : `code` vaut `confirmer`, et `email` dit l'adresse qui se connecterait.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/session/google": {
      "post": {
        "operationId": "commencerGoogle",
        "summary": "Commencer une connexion avec Google",
        "description": "Rend l'adresse de Google où aller, et pose un cookie qui lie la demande à ce navigateur (état, PKCE, nonce). Google ramène à `/connexion`.",
        "tags": ["Session"],
        "x-ecrans": ["S10"],
        "security": [],
        "responses": {
          "200": { "description": "L'adresse de Google.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdresseDeSortie" } } } },
          "403": { "$ref": "#/components/responses/Interdit" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/session/google/retour": {
      "post": {
        "operationId": "revenirDeGoogle",
        "summary": "Se connecter avec ce que Google a rendu",
        "description": "Google ne fait foi que pour Gmail et ses domaines Workspace : une autre adresse répond `422`, sur le champ `email`, et passe par le lien. La première connexion crée le compte.",
        "tags": ["Session"],
        "x-ecrans": ["S10"],
        "security": [],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetourGoogle" } } } },
        "responses": {
          "204": { "$ref": "#/components/responses/SessionOuverte" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/session/cle/options": {
      "post": {
        "operationId": "optionsConnexionCle",
        "summary": "Préparer une connexion par clé d'accès",
        "tags": ["Session"],
        "x-ecrans": ["S10"],
        "security": [],
        "responses": {
          "200": { "description": "Les options WebAuthn, avec leur défi.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OptionsCleAcces" } } } },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/session/cle": {
      "post": {
        "operationId": "connecterParCle",
        "summary": "Se connecter par clé d'accès",
        "tags": ["Session"],
        "x-ecrans": ["S10"],
        "security": [],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReponseCleAcces" } } } },
        "responses": {
          "204": { "$ref": "#/components/responses/SessionOuverte" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/session": {
      "delete": {
        "operationId": "deconnecter",
        "summary": "Se déconnecter",
        "tags": ["Session"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      }
    },
    "/moi": {
      "get": {
        "operationId": "lireMoi",
        "summary": "Lire l'utilisateur connecté et ses comptes",
        "description": "Lu par chaque écran de l'espace client : le nom du compte dans l'en-tête, et les compteurs de la barre latérale.",
        "tags": ["Session"],
        "x-ecrans": ["A01", "A02", "A05", "A09", "A10", "A12", "A21"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "L'utilisateur, ses comptes, et le compte courant.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Moi" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      },
      "patch": {
        "operationId": "modifierMoi",
        "summary": "Changer le nom de la personne connectée",
        "description": "Celui que voient les autres membres. Vide ou null, il s'efface. Un nom qui porte une arobase (« @ », ou ses formes pleine chasse et petite) est refusé (422) : il passerait pour l'adresse d'un autre membre, et le journal montre l'adresse à côté du nom.",
        "tags": ["Session"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": ["nom"], "properties": { "nom": { "type": ["string", "null"], "maxLength": 80 } } } } } },
        "responses": {
          "200": { "description": "La personne.", "content": { "application/json": { "schema": { "type": "object", "required": ["id", "email", "nom"], "properties": { "id": { "type": "string" }, "email": { "type": "string", "format": "email" }, "nom": { "type": ["string", "null"] } } } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/moi/compte": {
      "put": {
        "operationId": "choisirCompte",
        "summary": "Changer de compte courant",
        "tags": ["Session"],
        "x-ecrans": ["A02"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChoixCompte" } } } },
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/invitations/accepter": {
      "post": {
        "operationId": "accepterInvitation",
        "summary": "Accepter une invitation à un compte",
        "description": "Le lien de l'e-mail M14 ouvre l'espace client ; l'invité se connecte avec l'adresse invitée, puis la page envoie le jeton ici.",
        "tags": ["Session"],
        "x-ecrans": ["S10"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Jeton" } } } },
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/tableau": {
      "get": {
        "operationId": "lireTableau",
        "summary": "Lire le tableau de bord",
        "description": "Les blocs d'A02 ; A07 y lit « Suis-je touché ? ». Une faille ne s'y nomme que sur un site sous un domaine prouvé (ECRANS.md, Q1) : ailleurs, le site a sa ligne dans « À traiter », et la faille son compte par sévérité, sans son nom.",
        "tags": ["Sondes"],
        "x-ecrans": ["A02", "A07"],
        "responses": {
          "200": { "description": "L'état d'ensemble du compte.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Tableau" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      }
    },
    "/bannieres": {
      "get": {
        "operationId": "lireBannieres",
        "summary": "Lire les bannières du compte",
        "description": "Ce qui dure et touche tout le compte, dans l'ordre d'affichage (ECRANS.md §6.3) : les failles exploitées qui laissent un site exposé, les ordres sans suite, le paiement refusé, les preuves perdues. Une faille ne s'y nomme que sur un site sous un domaine prouvé (Q1). L'écran y ajoute les sources muettes et le réseau du navigateur.",
        "tags": ["Sondes"],
        "x-ecrans": ["A03", "A05", "A07", "A08", "A09", "A11", "A13", "A20"],
        "responses": {
          "200": { "description": "Les bannières actives, les plus urgentes d'abord.", "content": { "application/json": { "schema": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Banniere" } } } } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      }
    },
    "/sondes": {
      "get": {
        "operationId": "listerSondes",
        "summary": "Lister les sondes",
        "tags": ["Sondes"],
        "x-ecrans": ["A03", "A10", "A11"],
        "parameters": [
          { "name": "etat", "in": "query", "schema": { "$ref": "#/components/schemas/EtatSonde" } },
          { "name": "domaine", "in": "query", "schema": { "type": "string", "pattern": "^dom_[0-9A-Za-z]{22}$" } },
          { "name": "couvertesPar", "in": "query", "description": "Les sites que ce nom couvre, lui et ses sous-domaines, jamais un nom qui lui ressemble (`monexemple.fr`) : « 3 sites s'y rattachent » à l'étape 1 d'A10, avant que le domaine soit ajouté.", "schema": { "type": "string", "pattern": "^[a-z0-9.-]{1,253}$" } },
          { "name": "recherche", "in": "query", "schema": { "type": "string", "maxLength": 100 } },
          { "$ref": "#/components/parameters/Apres" },
          { "$ref": "#/components/parameters/Limite" }
        ],
        "responses": {
          "200": { "description": "Une page de sondes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageSondes" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      },
      "post": {
        "operationId": "creerSondes",
        "summary": "Créer une ou plusieurs sondes",
        "tags": ["Sondes"],
        "x-ecrans": ["A01", "A04"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouvellesSondes" } } } },
        "responses": {
          "201": { "description": "Les sondes créées. La stack de chacune est lue de l'extérieur dans la minute.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SondesCreees" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sondes/lot": {
      "post": {
        "operationId": "agirSurSondes",
        "summary": "Agir sur plusieurs sondes à la fois",
        "description": "Supprimer, ou passer à 5 minutes, une sonde dont la recette est posée, ou sous protection, demande à une clé d'API le droit des ordres (403 `cle_sans_ordres`).",
        "tags": ["Sondes"],
        "x-ecrans": ["A03", "O10"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lot" } } } },
        "responses": {
          "200": { "description": "Le nombre de sondes changées.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResultatLot" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sondes/{sonde}": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "get": {
        "operationId": "lireSonde",
        "summary": "Lire une sonde",
        "tags": ["Sondes"],
        "x-ecrans": ["A05", "A12"],
        "responses": {
          "200": { "description": "La sonde.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Sonde" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      },
      "patch": {
        "operationId": "modifierSonde",
        "summary": "Modifier une sonde",
        "description": "Passer à 5 minutes une sonde dont la recette est posée, ou sous protection, la sort de la protection, et demande donc à une clé d'API le droit des ordres (403 `cle_sans_ordres`). La pause ne change rien aux ordres : une sonde en pause reçoit ceux de sa politique et du bouton d'urgence comme les autres.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModifSonde" } } } },
        "responses": {
          "200": { "description": "La sonde modifiée.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Sonde" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      },
      "delete": {
        "operationId": "supprimerSonde",
        "summary": "Supprimer une sonde",
        "description": "Une sonde dont la recette est posée, ou sous protection, demande à une clé d'API le droit des ordres (403 `cle_sans_ordres`), car la supprimer rouvre le site. Un garde qui lisait son état reçoit ensuite un an l'état normal de son départ, `parti` à vrai.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05"],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/sondes/{sonde}/jeton": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "post": {
        "operationId": "renouvelerJeton",
        "summary": "Renouveler l'adresse d'un battement",
        "description": "Une nouvelle adresse à appeler. L'ancienne ne bat plus, tout de suite : qui l'a lue, un membre parti par exemple, ne peut plus battre à la place de la tâche. Une sonde http répond 409. Noté au journal, avec son auteur.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05", "A18"],
        "responses": {
          "200": { "description": "Le battement, avec sa nouvelle adresse.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Sonde" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" }
        }
      }
    },
    "/sondes/{sonde}/verifier": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "post": {
        "operationId": "verifierSonde",
        "summary": "Vérifier une sonde tout de suite",
        "description": "« Vérifier maintenant » d'A05 : une vérification hors de son créneau, comme les autres : une panne ne s'ouvre que vue de deux régions. Une par minute au plus pour une même sonde. Un battement ou une sonde en pause répond 409. Noté au journal, avec son auteur.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05"],
        "responses": {
          "200": { "description": "La sonde, après cette vérification.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Sonde" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sondes/{sonde}/mesures": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "get": {
        "operationId": "lireMesures",
        "summary": "Lire la disponibilité et le temps de réponse",
        "description": "La période se découpe en tranches à l'heure du compte : 24 heures et 7 jours heure par heure, 30 et 90 jours jour par jour. La dernière tranche est en cours : elle finit maintenant.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05"],
        "parameters": [{ "name": "periode", "in": "query", "schema": { "type": "string", "enum": ["24h", "7j", "30j", "90j"], "default": "30j" } }],
        "responses": {
          "200": { "description": "Les mesures de la période, et ses incidents.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Mesures" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/sondes/{sonde}/stack": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "get": {
        "operationId": "lireStack",
        "summary": "Lire la stack d'une sonde",
        "description": "Sans stack donnée par le compte, la page d'accueil du site se lit de l'extérieur dès la minute qui suit sa création, puis tous les 30 jours : ses logiciels sont « probables ». Une stack donnée par le compte n'est jamais remplacée par cette lecture.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05"],
        "responses": {
          "200": { "description": "La liste des logiciels, et d'où elle vient.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Stack" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      },
      "put": {
        "operationId": "poserStack",
        "summary": "Donner la stack d'une sonde",
        "description": "Par les questions, par un dépôt GitHub, ou par un fichier (SBOM ou fichier de verrouillage). Les questions et les fichiers se lisent tout de suite ; GitHub attend son application (C15, 503 d'ici là). Un fichier déposé par la session a l'origine « fichier », par une clé d'API, celle d'une CI, « ci » ; le dernier se garde. GitHub et la CI tiennent la stack à jour sans geste : ils viennent avec une formule (docs/PLAN.md §9 ; sans elle, 403 `offre_insuffisante`) ; les questions et le fichier déposé par la session restent gratuits. 20 000 logiciels au plus. Une stack donnée remplace la précédente ; une lecture de l'extérieur ne remplace jamais une stack donnée par le compte. La CI envoie le fichier ici, avec une clé d'API, de préférence limitée à ce site (`NouvelleCle.sonde`, O02) : `curl -X PUT -H \"Authorization: Bearer $MANICOU_CLE\" -F fichier=@package-lock.json …/sondes/<sonde>/stack`. Une clé limitée n'y dépose qu'un fichier, sur son site : les questions, GitHub ou un autre site répondent 403 `cle_limitee`. Soixante listes par minute et par compte au plus. Une liste identique à la précédente ne réécrit rien et se redépose sans autre limite, ce que fait une CI à chaque déploiement. Une liste qui change n'écrit que ce qui change, vingt fois par heure et par site au plus, et un compte écrit au plus 5 000 logiciels par jour pour chacun de ses 50 sites gratuits et de ceux de sa formule. Au-delà, 429 avec la raison et `Retry-After`. Une autre liste écrite pour ce site au même instant, 409.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05", "A06", "O02"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": { "schema": { "$ref": "#/components/schemas/NouvelleStack" } },
            "multipart/form-data": { "schema": { "$ref": "#/components/schemas/FichierStack" } }
          }
        },
        "responses": {
          "202": { "description": "La liste est en lecture ; `etat` passe à `lue` quand elle est prête.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Stack" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "413": { "$ref": "#/components/responses/TropGros" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sondes/{sonde}/technos": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "put": {
        "operationId": "poserTechnos",
        "summary": "Déclarer les technos d'une sonde",
        "description": "N'importe quel logiciel, sous le nom que le compte lui donne, avec sa version s'il la connaît. Les technos s'ajoutent à la stack, quelle que soit son origine, et aucune lecture ne les remplace : ni l'extérieur, ni les questions, ni un fichier, ni la CI. Chaque logiciel de la réponse dit ce que la veille en suit.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouvellesTechnos" } } } },
        "responses": {
          "200": { "description": "La stack, avec ces technos.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Stack" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sondes/{sonde}/failles": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "get": {
        "operationId": "listerFaillesDeSonde",
        "summary": "Lister les failles qui touchent une sonde",
        "description": "Sous un domaine non prouvé, ses failles se comptent sans leur nom : c'est l'onglet Failles d'A05.",
        "tags": ["Failles"],
        "x-ecrans": ["A05"],
        "parameters": [{ "$ref": "#/components/parameters/Apres" }, { "$ref": "#/components/parameters/Limite" }],
        "responses": {
          "200": { "description": "Une page d'atteintes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageAtteintes" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/sondes/{sonde}/mise-a-jour-seule": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "put": {
        "operationId": "preciserMiseAJourSeule",
        "summary": "Activer ou couper la mise à jour seule d'un site",
        "description": "Le site qui l'a choisie, Manicou lance son workflow GitHub seul, à chaque tour de veille, dès qu'une faille alertée, sûre ou probable, a une version corrigée au-dessus de la sienne ; une fois par faille, sous un domaine prouvé et protégé (D-106). Coupée par défaut. Elle lance des workflows sans clic : une clé d'API a besoin du droit des ordres, comme pour le bouton.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["active"], "additionalProperties": false, "properties": { "active": { "type": "boolean" } } } } } },
        "responses": {
          "200": { "description": "Le choix enregistré, et noté au journal.", "content": { "application/json": { "schema": { "type": "object", "required": ["active"], "properties": { "active": { "type": "boolean" } } } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/sondes/{sonde}/protection": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "get": {
        "operationId": "lireProtection",
        "summary": "Lire la protection d'une sonde",
        "tags": ["Sondes"],
        "x-ecrans": ["A05", "A12"],
        "responses": {
          "200": { "description": "Le niveau en cours, la recette, les derniers ordres.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Protection" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      },
      "put": {
        "operationId": "poserProtection",
        "summary": "Déclarer la recette posée",
        "tags": ["Sondes"],
        "x-ecrans": ["A12"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouvelleProtection" } } } },
        "responses": {
          "200": { "description": "La protection.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Protection" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/sondes/{sonde}/essai": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "post": {
        "operationId": "essayerOrdre",
        "summary": "Envoyer un ordre d'essai",
        "tags": ["Sondes"],
        "x-ecrans": ["A12", "A05"],
        "responses": {
          "202": { "description": "L'ordre d'essai ; l'accusé du site, l'effet constaté et le retour à la normale se lisent ensuite.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ordre" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" }
        }
      }
    },
    "/sondes/{sonde}/lever": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "post": {
        "operationId": "leverProtection",
        "summary": "Lever la protection d'une sonde",
        "description": "« Lever » de l'onglet Protection d'A05 (C26) : l'ordre `normal` part, signé, et se suit par `/ordres/{ordre}`. Tant qu'une faille reste ouverte sur ce site, `avantCorrectif` doit être vrai, sinon 422 : c'est la confirmation « La faille n'est pas corrigée. » Ses atteintes passent levées (`leveeLe`). Sous un domaine non prouvé, 403 `domaine_non_prouve` ; au niveau normal, 409. Noté au journal, avec son auteur.",
        "tags": ["Sondes"],
        "x-ecrans": ["A05"],
        "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Levee" } } } },
        "responses": {
          "202": { "description": "L'ordre `normal` ; l'accusé du site et l'effet constaté se lisent ensuite.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ordre" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/sondes/{sonde}/fenetres": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }],
      "get": {
        "operationId": "listerFenetres",
        "summary": "Lister les fenêtres de maintenance",
        "tags": ["Sondes"],
        "x-ecrans": ["A05", "O09"],
        "responses": {
          "200": { "description": "Les fenêtres prévues.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListeFenetres" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      },
      "post": {
        "operationId": "creerFenetre",
        "summary": "Prévoir une fenêtre de maintenance",
        "tags": ["Sondes"],
        "x-ecrans": ["O09"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouvelleFenetre" } } } },
        "responses": {
          "201": { "description": "La fenêtre.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Fenetre" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/sondes/{sonde}/fenetres/{fenetre}": {
      "parameters": [{ "$ref": "#/components/parameters/Sonde" }, { "$ref": "#/components/parameters/Fenetre" }],
      "delete": {
        "operationId": "supprimerFenetre",
        "summary": "Supprimer une fenêtre de maintenance",
        "tags": ["Sondes"],
        "x-ecrans": ["O09"],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/ordres/{ordre}": {
      "parameters": [{ "$ref": "#/components/parameters/Ordre" }],
      "get": {
        "operationId": "lireOrdre",
        "summary": "Suivre un ordre",
        "tags": ["Sondes"],
        "x-ecrans": ["A05", "A12"],
        "responses": {
          "200": { "description": "L'ordre, son accusé et l'effet constaté.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ordre" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/github/installation": {
      "post": {
        "operationId": "commencerInstallationGithub",
        "summary": "Commencer l'installation de l'application GitHub",
        "description": "Rend l'adresse de GitHub où aller, avec un `state` lié à la session. GitHub tient la stack à jour à chaque push : avec une formule (docs/PLAN.md §9 ; sans elle, 403 `offre_insuffisante`). Sans formule, un push ne relit plus rien, et la dernière liste reste.",
        "tags": ["Sondes"],
        "x-ecrans": ["A06", "O01"],
        "responses": {
          "200": { "description": "L'adresse de GitHub.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdresseDeSortie" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" },
          "503": { "description": "L'application GitHub n'est pas encore ouverte.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
        }
      }
    },
    "/github/installation/retour": {
      "post": {
        "operationId": "terminerInstallationGithub",
        "summary": "Revenir de l'installation de l'application GitHub",
        "description": "L'`installation_id` du retour peut être falsifié, GitHub le dit : rien n'est relié ici. L'état dit qui a demandé l'installation, et la réponse est l'adresse où la personne autorise Manicou chez GitHub, avec un nouvel état, quinze minutes. Chaque refus a le même message.",
        "tags": ["Sondes"],
        "x-ecrans": ["A06"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetourGithub" } } } },
        "responses": {
          "200": { "description": "L'adresse de l'autorisation chez GitHub.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdresseDeSortie" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" },
          "503": { "description": "L'application GitHub n'est pas encore ouverte.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
        }
      }
    },
    "/github/installation/autorisation": {
      "post": {
        "operationId": "autoriserInstallationGithub",
        "summary": "Relier l'installation, une fois Manicou autorisé",
        "description": "Le code que GitHub donne à l'autorisation s'échange contre un jeton de la personne, qui doit voir l'installation (`GET /user/installations`) ; ce jeton n'est gardé nulle part, et il est révoqué aussitôt. L'installation n'est reliée que si aucun autre compte ne l'a. Chaque refus a le même message : la réponse ne dit pas ce qu'une installation est, ni à qui.",
        "tags": ["Sondes"],
        "x-ecrans": ["A06"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutorisationGithub" } } } },
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" },
          "503": { "description": "GitHub ne répond pas, ou l'application n'est pas encore ouverte : rien n'est relié.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
        }
      }
    },
    "/github/depots": {
      "get": {
        "operationId": "listerDepotsGithub",
        "summary": "Lister les dépôts que l'application peut lire",
        "tags": ["Sondes"],
        "x-ecrans": ["A06"],
        "responses": {
          "200": { "description": "Les dépôts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DepotsGithub" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      }
    },
    "/failles": {
      "get": {
        "operationId": "listerFailles",
        "summary": "Lister les failles qui touchent le compte",
        "tags": ["Failles"],
        "x-ecrans": ["A07"],
        "parameters": [
          { "name": "severite", "in": "query", "schema": { "$ref": "#/components/schemas/Severite" } },
          { "name": "exploitee", "in": "query", "schema": { "type": "boolean" } },
          { "name": "etat", "in": "query", "description": "L'onglet d'A07.", "schema": { "type": "string", "enum": ["ouverte", "protegee", "corrigee", "a_verifier", "ecartee"] } },
          { "name": "correctif", "in": "query", "description": "Les failles dont une source donne une version corrigée, ou les autres.", "schema": { "type": "boolean" } },
          { "name": "sonde", "in": "query", "schema": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" } },
          { "name": "recherche", "in": "query", "description": "Par identifiant (CVE, GHSA) ou par logiciel.", "schema": { "type": "string", "maxLength": 100 } },
          { "$ref": "#/components/parameters/Apres" },
          { "$ref": "#/components/parameters/Limite" }
        ],
        "responses": {
          "200": { "description": "Une page de failles.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageFailles" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/failles/{faille}": {
      "parameters": [{ "$ref": "#/components/parameters/Faille" }],
      "get": {
        "operationId": "lireFaille",
        "summary": "Lire une faille, et les sites qu'elle touche",
        "description": "C'est « Suis-je touché ? » : la liste des sites du compte que la faille touche. Sur A08, une ligne par site : le pire état de ses atteintes. Un site sous un domaine non prouvé n'y paraît jamais, ni dans ses comptes, ni dans ses dates, ni dans ses délais : la faille ne s'y nomme pas (ECRANS.md, Q1). `aProuver` dit seulement que la réponse n'est pas complète, pour tout le compte : deux failles, l'une qui touche ce site et l'autre non, reçoivent la même réponse.",
        "tags": ["Failles"],
        "x-ecrans": ["A08"],
        "responses": {
          "200": { "description": "La faille, ses logiciels, ses atteintes et ses délais.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FailleDetail" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/failles/{faille}/ecart": {
      "parameters": [{ "$ref": "#/components/parameters/Faille" }],
      "put": {
        "operationId": "ecarterFaille",
        "summary": "Écarter une faille, avec une raison",
        "description": "Pour les sites du compte sous un domaine prouvé que la faille touche à cet instant, et qui ne sont pas corrigés. Un site touché ensuite alerte comme les autres, et une faille écartée qui devient exploitée alerte de nouveau : dans le doute, protéger. Les rappels (M10) s'arrêtent. Noté au journal, avec son auteur. Écarter la faille d'un site dont la recette est posée, ou sous protection, le sort de la protection, et demande donc à une clé d'API le droit des ordres (403 `cle_sans_ordres`).",
        "tags": ["Failles"],
        "x-ecrans": ["A08", "A07"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ecart" } } } },
        "responses": {
          "200": { "description": "La faille, écartée.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FailleDetail" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      },
      "delete": {
        "operationId": "retablirFaille",
        "summary": "Rétablir une faille écartée",
        "description": "« Rétablir », ou « Annuler » dans le toast : ses sites reprennent leur état, et les rappels repartent. Sans effet sur une faille qui n'est pas écartée. Noté au journal, avec son auteur.",
        "tags": ["Failles"],
        "x-ecrans": ["A08", "A07"],
        "responses": {
          "200": { "description": "La faille, rétablie.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FailleDetail" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/failles/{faille}/mise-a-jour": {
      "parameters": [{ "$ref": "#/components/parameters/Faille" }],
      "post": {
        "operationId": "lancerMiseAJour",
        "summary": "Lancer la mise à jour des sites qu'une faille touche",
        "description": "« Lancer la mise à jour » d'A08 : le workflow de chaque site du compte sous un domaine prouvé que la faille touche, s'il est posé et que le correctif existe (C26). Avant de lancer, Manicou lit le workflow, le verrou npm et le .node-version sur la branche par défaut, ne lance que pour un paquet du verrou npm ou pour Node, et refuse lui-même ce que GitHub ou le workflow du kit refuseraient. Chaque lancement porte une décision en chiffres, demande l'identifiant du run, et se suit jusqu'à son issue, que le journal du compte dit. La faille n'est corrigée que quand la liste relue du site montre la version corrigée (D-115).",
        "tags": ["Failles"],
        "x-ecrans": ["A08"],
        "responses": {
          "202": { "description": "Les workflows sont lancés. `incertaines`, les sites dont GitHub n'a pas dit si le run est parti, une coupure ou un 5xx après l'envoi : leur paire reste prise, et Manicou cherche le run par sa décision dix minutes plus tard, avant de conclure (D18). `refus`, les sites que Manicou ou GitHub ont refusés, s'il y en a.", "content": { "application/json": { "schema": { "type": "object", "required": ["sondes"], "properties": { "sondes": { "type": "array", "items": { "type": "string" } }, "incertaines": { "type": "array", "items": { "type": "string" } }, "refus": { "type": "array", "items": { "$ref": "#/components/schemas/RefusDeMiseAJour" } } } } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "description": "Rien n'est parti. `code` vaut `mise_a_jour_refusee` quand Manicou ou GitHub a refusé chaque site, `refus` disant pourquoi et `title` la raison du premier, et `conflit` quand aucun site n'est à mettre à jour (déjà lancée, sans correctif, sans workflow, sous un domaine non prouvé).", "content": { "application/problem+json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/Probleme" }, { "type": "object", "properties": { "refus": { "type": "array", "items": { "$ref": "#/components/schemas/RefusDeMiseAJour" } } } }] } } } },
          "429": { "$ref": "#/components/responses/TropDeRequetes" },
          "503": { "description": "L'exploitant a suspendu la mise à jour pour tous les comptes (`mise_a_jour_coupee`, son interrupteur global). Rien ne part.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
        }
      }
    },
    "/urgence": {
      "post": {
        "operationId": "mettreALAbri",
        "summary": "Bouton d'urgence : mettre à l'abri les sites exposés",
        "description": "Pour une faille, ou pour tous les sites qui font tourner un logiciel. Pour une faille, seulement les sites qu'elle expose encore : un site déjà protégé ne compte pas. Seulement sur les domaines prouvés du compte : une faille qui ne touche qu'un autre site répond `422`, exactement comme une faille qui ne touche rien.",
        "tags": ["Failles"],
        "x-ecrans": ["O03", "A02", "A07", "A08"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Urgence" } } } },
        "responses": {
          "202": { "description": "Les ordres partent.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResultatUrgence" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "503": { "description": "Les ordres signés ne sont pas encore en service (C22) : rien ne part, rien ne s'écrit ; `sondes` dit les sites qui l'auraient été.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
        }
      }
    },
    "/domaines": {
      "get": {
        "operationId": "listerDomaines",
        "summary": "Lister les domaines",
        "tags": ["Domaines"],
        "x-ecrans": ["A09"],
        "responses": {
          "200": { "description": "Les domaines du compte.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListeDomaines" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      },
      "post": {
        "operationId": "ajouterDomaine",
        "summary": "Ajouter un domaine à prouver",
        "tags": ["Domaines"],
        "x-ecrans": ["A10"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouveauDomaine" } } } },
        "responses": {
          "201": { "description": "Le domaine, avec l'enregistrement TXT et le fichier qui le prouvent.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Domaine" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/domaines/{domaine}": {
      "parameters": [{ "$ref": "#/components/parameters/Domaine" }],
      "get": {
        "operationId": "lireDomaine",
        "summary": "Lire un domaine",
        "tags": ["Domaines"],
        "x-ecrans": ["A11", "A10"],
        "responses": {
          "200": { "description": "Le domaine.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Domaine" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      },
      "delete": {
        "operationId": "retirerDomaine",
        "summary": "Retirer un domaine",
        "description": "Ses sondes restent, sans protection ni ordre. Quand l'une d'elles a sa recette posée, ou est sous protection, une clé d'API doit avoir le droit des ordres (403 `cle_sans_ordres`).",
        "tags": ["Domaines"],
        "x-ecrans": ["A11"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Confirmation" } } } },
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/domaines/{domaine}/verifier": {
      "parameters": [{ "$ref": "#/components/parameters/Domaine" }],
      "post": {
        "operationId": "verifierDomaine",
        "summary": "Vérifier la preuve d'un domaine",
        "tags": ["Domaines"],
        "x-ecrans": ["A10", "A11"],
        "responses": {
          "200": { "description": "Le domaine, prouvé ou non ; `raison` dit ce qui manque.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Domaine" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/politiques": {
      "get": {
        "operationId": "lirePolitiques",
        "summary": "Lire les politiques par sévérité",
        "tags": ["Alertes"],
        "x-ecrans": ["A16", "A05"],
        "responses": {
          "200": { "description": "La politique du compte, et celles propres à certaines sondes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Politiques" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      },
      "put": {
        "operationId": "poserPolitiques",
        "summary": "Changer les politiques par sévérité",
        "tags": ["Alertes"],
        "x-ecrans": ["A16", "A05", "O05"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouvellesPolitiques" } } } },
        "responses": {
          "200": { "description": "Les politiques.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Politiques" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/canaux": {
      "get": {
        "operationId": "listerCanaux",
        "summary": "Lister les canaux d'alerte",
        "tags": ["Alertes"],
        "x-ecrans": ["A17"],
        "responses": {
          "200": { "description": "Les canaux.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListeCanaux" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" }
        }
      },
      "post": {
        "operationId": "ajouterCanal",
        "summary": "Ajouter un canal d'alerte",
        "tags": ["Alertes"],
        "x-ecrans": ["O06"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouveauCanal" } } } },
        "responses": {
          "201": { "description": "Le canal.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Canal" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/canaux/{canal}": {
      "parameters": [{ "$ref": "#/components/parameters/Canal" }],
      "delete": {
        "operationId": "supprimerCanal",
        "summary": "Supprimer un canal d'alerte",
        "tags": ["Alertes"],
        "x-ecrans": ["A17"],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/canaux/{canal}/essai": {
      "parameters": [{ "$ref": "#/components/parameters/Canal" }],
      "post": {
        "operationId": "essayerCanal",
        "summary": "Envoyer une alerte d'essai",
        "description": "Un webhook dont l'adresse n'est pas vérifiée ne reçoit rien, pas même un essai : 409 `adresse_a_verifier`. Vingt essais par jour et par compte, vérifications comprises.",
        "tags": ["Alertes"],
        "x-ecrans": ["O06", "A17"],
        "responses": {
          "202": { "$ref": "#/components/responses/Accepte" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/canaux/{canal}/verification": {
      "parameters": [{ "$ref": "#/components/parameters/Canal" }],
      "post": {
        "operationId": "verifierCanal",
        "summary": "Vérifier l'adresse d'un webhook",
        "description": "Le défi de l'extension « endpoint verification » de Standard Webhooks, envoyé tout de suite (le webhook `verification`) : le receveur répond 2xx avec `webhook-challenge-response`, calculé avec le secret du canal. 200 et le canal, son adresse vérifiée, qui reçoit alors les alertes. 422 sur `cible` sinon, avec `verification`, sa raison (`injoignable`, `code`, `sans_reponse`, `reponse_fausse`, `adresse`) et le code HTTP reçu. Elle compte parmi les vingt essais du jour, avant de partir. 409 `secret_manquant` pour un webhook sans secret, et `conflit` si le secret change pendant la vérification. Un webhook seulement, 422 pour un autre canal.",
        "tags": ["Alertes"],
        "x-ecrans": ["O06", "A17"],
        "responses": {
          "200": { "description": "Le canal, son adresse vérifiée.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Canal" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/canaux/{canal}/secret": {
      "parameters": [{ "$ref": "#/components/parameters/Canal" }],
      "post": {
        "operationId": "renouvelerSecret",
        "summary": "Un nouveau secret pour un webhook",
        "description": "Le nouveau secret, dans `secret`, cette seule fois. L'ancien ne signe plus rien, et l'adresse se vérifie de nouveau avant la prochaine alerte. Un webhook d'avant la 0.12.175, qui n'en a pas, reçoit ainsi le sien. Un webhook seulement, 422 pour un autre canal.",
        "tags": ["Alertes"],
        "x-ecrans": ["A17"],
        "responses": {
          "200": { "description": "Le canal, avec son nouveau secret, à vérifier.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Canal" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/journal": {
      "get": {
        "operationId": "lireJournal",
        "summary": "Lire le journal du compte",
        "description": "Ce qui arrive aux sites et au compte : les pannes et les retours, les alertes envoyées, les échéances, les gestes de chacun (sites, fenêtres, canaux, clés, équipe, compte). Gardé 30 jours, un an avec l'offre payée. Le titre est dans la langue du compte au moment de l'événement. « recherche » cherche dans les titres.",
        "tags": ["Alertes"],
        "x-ecrans": ["A13", "A05", "O04"],
        "parameters": [
          { "name": "sonde", "in": "query", "schema": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" } },
          { "name": "faille", "in": "query", "schema": { "type": "string", "maxLength": 64 } },
          { "name": "genre", "in": "query", "schema": { "type": "string", "maxLength": 40 } },
          { "name": "importance", "in": "query", "schema": { "type": "string", "enum": ["info", "attention", "grave"] } },
          { "name": "depuis", "in": "query", "schema": { "type": "string", "format": "date-time" } },
          { "name": "jusqua", "in": "query", "schema": { "type": "string", "format": "date-time" } },
          { "name": "recherche", "in": "query", "schema": { "type": "string", "maxLength": 100 } },
          { "$ref": "#/components/parameters/Apres" },
          { "$ref": "#/components/parameters/Limite" }
        ],
        "responses": {
          "200": { "description": "Une page d'événements, le plus récent d'abord.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageEvenements" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/journal.csv": {
      "get": {
        "operationId": "exporterJournal",
        "summary": "Exporter le journal en CSV",
        "description": "Colonnes : le, genre, importance, titre, sonde, faille, envoi, etat_envoi ; le plus récent d'abord, 100 000 lignes au plus, en UTF-8 avec BOM. Une cellule qui commence par =, +, -, @ ou une tabulation est précédée d'une apostrophe : un tableur ne la lit pas comme une formule. Trois exports par minute et par compte au plus, au-delà 429.",
        "tags": ["Alertes"],
        "x-ecrans": ["A13"],
        "parameters": [
          { "name": "sonde", "in": "query", "schema": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" } },
          { "name": "genre", "in": "query", "description": "Un genre, ou plusieurs séparés par des virgules, comme sur la liste.", "schema": { "type": "string", "maxLength": 200 } },
          { "name": "importance", "in": "query", "schema": { "type": "string", "enum": ["info", "attention", "grave"] } },
          { "name": "depuis", "in": "query", "schema": { "type": "string", "format": "date-time" } },
          { "name": "jusqua", "in": "query", "schema": { "type": "string", "format": "date-time" } },
          { "name": "recherche", "in": "query", "description": "Un mot du titre, comme sur la liste.", "schema": { "type": "string", "maxLength": 100 } }
        ],
        "responses": {
          "200": { "description": "Le journal, une ligne par événement, avec les mêmes filtres que la liste.", "content": { "text/csv": { "schema": { "type": "string" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/envois/{envoi}/renvoyer": {
      "parameters": [{ "$ref": "#/components/parameters/Envoi" }],
      "post": {
        "operationId": "renvoyer",
        "summary": "Renvoyer une alerte",
        "description": "L'envoi repart tel quel, sous le même identifiant (celui du webhook, `webhook-id` : un receveur qui l'a déjà traité le reconnaît), avec un nouveau calendrier d'essais. Vingt renvois par jour et par compte au plus. Un envoi encore en attente répond 202 sans rien changer.",
        "tags": ["Alertes"],
        "x-ecrans": ["O04"],
        "responses": {
          "202": { "$ref": "#/components/responses/Accepte" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/pages": {
      "get": {
        "operationId": "listerPages",
        "summary": "Lister les pages de statut",
        "tags": ["Pages de statut"],
        "x-ecrans": ["A14"],
        "responses": {
          "200": { "description": "Les pages.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListePages" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      },
      "post": {
        "operationId": "creerPage",
        "summary": "Créer une page de statut",
        "description": "Une page dans l'offre gratuite, avec la mention ; vingt avec un domaine payé (403 offre_insuffisante au-delà de l'offre). Le nom est à tous les comptes : déjà pris, 409. Quelques noms sont réservés (api, app, www, status, admin…), comme tout nom qui reprend Manicou ou une marque souvent imitée, même écrit avec des tirets ou des chiffres à la place de lettres (manicou-support, paypa1, impots-gouv), refusé en 422 sur le champ nom, avec le mot « réservé » (D-127). Les sites, cent au plus, sont ceux du compte, dans l'ordre de la page. Dix créations ou suppressions de pages par minute et par compte au plus, et soixante requêtes sur les pages, au-delà 429.",
        "tags": ["Pages de statut"],
        "x-ecrans": ["A15"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouvellePage" } } } },
        "responses": {
          "201": { "description": "La page.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageStatut" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/pages/{page}": {
      "parameters": [{ "$ref": "#/components/parameters/Page" }],
      "get": {
        "operationId": "lirePage",
        "summary": "Lire une page de statut",
        "tags": ["Pages de statut"],
        "x-ecrans": ["A15"],
        "responses": {
          "200": { "description": "La page.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageStatut" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      },
      "patch": {
        "operationId": "modifierPage",
        "summary": "Modifier une page de statut",
        "description": "Le titre, les sites et leur ordre, la visibilité. Retirer la mention demande un domaine payé (403 offre_insuffisante).",
        "tags": ["Pages de statut"],
        "x-ecrans": ["A15"],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModifPage" } } } },
        "responses": {
          "200": { "description": "La page.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageStatut" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      },
      "delete": {
        "operationId": "supprimerPage",
        "summary": "Supprimer une page de statut",
        "description": "Son nom reste un an à ce compte si la page est restée publique trois jours de suite, et un autre compte reçoit 409. Un compte garde au plus autant de noms réservés que son offre permet de pages, les plus anciens rendus d'abord, et un nom qu'il reprend garde la date de sa première réserve. Dix créations ou suppressions par minute et par compte au plus, au-delà 429.",
        "tags": ["Pages de statut"],
        "x-ecrans": ["A15"],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/membres": {
      "get": {
        "operationId": "listerEquipe",
        "summary": "Lister les membres et les invitations",
        "tags": ["Réglages"],
        "x-ecrans": ["A18"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "L'équipe.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Equipe" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" }
        }
      }
    },
    "/membres/{membre}": {
      "parameters": [{ "$ref": "#/components/parameters/Membre" }],
      "patch": {
        "operationId": "modifierMembre",
        "summary": "Changer le rôle d'un membre",
        "tags": ["Réglages"],
        "x-ecrans": ["A18"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModifMembre" } } } },
        "responses": {
          "200": { "description": "Le membre.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Membre" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      },
      "delete": {
        "operationId": "retirerMembre",
        "summary": "Retirer un membre",
        "tags": ["Réglages"],
        "x-ecrans": ["A18"],
        "security": [{ "session": [] }],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/invitations": {
      "post": {
        "operationId": "inviter",
        "summary": "Inviter un membre",
        "tags": ["Réglages"],
        "x-ecrans": ["O07"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouvelleInvitation" } } } },
        "responses": {
          "201": { "description": "L'invitation ; l'e-mail M14 part, qui nomme qui invite par son adresse, et jamais le compte, dont le nom est un texte libre (D-127).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Invitation" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/invitations/{invitation}": {
      "parameters": [{ "$ref": "#/components/parameters/Invitation" }],
      "delete": {
        "operationId": "annulerInvitation",
        "summary": "Annuler une invitation",
        "tags": ["Réglages"],
        "x-ecrans": ["A18"],
        "security": [{ "session": [] }],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/cles": {
      "get": {
        "operationId": "listerCles",
        "summary": "Lister les clés d'API",
        "tags": ["Réglages"],
        "x-ecrans": ["A19"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "Les clés, sans leur valeur.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListeCles" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" }
        }
      },
      "post": {
        "operationId": "creerCle",
        "summary": "Créer une clé d'API",
        "description": "Pour tout le compte (O08), ou limitée à un site, le jeton d'une CI (O02, `sonde`).",
        "tags": ["Réglages"],
        "x-ecrans": ["O08", "O02"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NouvelleCle" } } } },
        "responses": {
          "201": { "description": "La clé, montrée cette seule fois.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CleCreee" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/cles/{cle}": {
      "parameters": [{ "$ref": "#/components/parameters/Cle" }],
      "delete": {
        "operationId": "revoquerCle",
        "summary": "Révoquer une clé d'API",
        "tags": ["Réglages"],
        "x-ecrans": ["A19"],
        "security": [{ "session": [] }],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/abonnement": {
      "get": {
        "operationId": "lireAbonnement",
        "summary": "Lire l'abonnement",
        "tags": ["Réglages"],
        "x-ecrans": ["A20"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "L'offre, les domaines payés, le prix garanti.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Abonnement" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" }
        }
      }
    },
    "/abonnement/portail": {
      "post": {
        "operationId": "ouvrirPortail",
        "summary": "Ouvrir le portail du marchand",
        "description": "Le portail de Paddle : ses factures et le moyen de paiement (A20). 409 sans abonnement. Le propriétaire seul l'ouvre, sur le client de son compte, six fois par minute au plus, puis 429 (D-147).",
        "tags": ["Réglages"],
        "x-ecrans": ["A20"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "L'adresse chez le marchand.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdresseDeSortie" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" },
          "503": { "description": "Le marchand ne répond pas, ou n'est pas encore en service (C27) : rien n'a été débité.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
        }
      }
    },
    "/abonnement/formule": {
      "post": {
        "operationId": "choisirFormule",
        "summary": "Choisir ou changer de formule",
        "description": "Sans abonnement : le paiement de la formule, dans la fenêtre du marchand ; la transaction créée se garde avec son compte, sa formule et son article, et seule elle activera la formule. Avec : le changement, au prorata, que l'événement signé du marchand (`/entrees/paiement`) appliquera, jamais le retour du navigateur : A20 relit l'abonnement. Descendre demande d'avoir au plus autant de sites à la minute que la nouvelle formule (409). Le prix est celui que montre `Abonnement.formules` (docs/PLAN.md §9). Au tiers du prix, le paiement tient une place du lancement 10 minutes, une seule par compte. Un nouveau paiement du compte reprend sa place, puis le précédent s'annule chez le marchand. Si la dernière place part entre-temps, 409, et rien n'est débité. Avec `prixParMois`, le prix que l'écran montrait, une hausse depuis donne aussi 409, sans rien demander au marchand (D-126). Le propriétaire seul le demande, et un changement se note au journal du compte avec son auteur (D-147). Chaque compte paie avec son client chez le marchand, créé à sa première demande. Un paiement rouvert garde l'heure de sa tenue, un compte en commence trois par jour au plus (429), et un changement ne tient qu'une place, rendue si le marchand le refuse (409). Six demandes par minute et par compte, puis 429.",
        "tags": ["Réglages"],
        "x-ecrans": ["A20"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DemandeFormule" } } } },
        "responses": {
          "200": { "description": "L'adresse du paiement chez le marchand.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SortieFormule" } } } },
          "202": { "description": "Le changement est demandé au marchand ; il s'applique à son événement signé.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SortieFormule" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "409": { "$ref": "#/components/responses/Conflit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" },
          "503": { "description": "Le marchand ne répond pas, ou n'est pas encore en service (C27) : rien n'a été débité.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
        }
      }
    },
    "/compte": {
      "get": {
        "operationId": "lireCompte",
        "summary": "Lire le compte",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "Le compte.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Compte" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      },
      "patch": {
        "operationId": "modifierCompte",
        "summary": "Modifier le compte : son nom, sa langue, son fuseau",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModifCompte" } } } },
        "responses": {
          "200": { "description": "Le compte.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Compte" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      },
      "delete": {
        "operationId": "fermerCompte",
        "summary": "Fermer le compte",
        "description": "Le compte se ferme tout de suite ; ses données sont supprimées 30 jours plus tard, fichiers compris. Une archive de toutes ses données se prépare, et son lien part par e-mail (M15), valable jusqu'à la suppression : le compte fermé ne s'ouvre plus. Un abonnement en cours s'arrête chez le marchand, tout de suite et sans autre prélèvement ; s'il ne s'arrête pas, le compte reste ouvert (503). L'application GitHub se désinstalle de chaque installation du compte.",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Confirmation" } } } },
        "responses": {
          "202": { "$ref": "#/components/responses/Accepte" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "503": { "description": "Le marchand n'a pas arrêté l'abonnement : `code` vaut `abonnement_non_arrete`, et rien n'est fermé.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
        }
      }
    },
    "/compte/cles-acces": {
      "get": {
        "operationId": "listerClesAcces",
        "summary": "Lister ses clés d'accès",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "Les clés d'accès de l'utilisateur.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListeClesAcces" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      },
      "post": {
        "operationId": "ajouterCleAcces",
        "summary": "Ajouter une clé d'accès",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReponseCleAcces" } } } },
        "responses": {
          "201": { "description": "La clé d'accès.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CleAcces" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "422": { "$ref": "#/components/responses/Invalide" }
        }
      }
    },
    "/compte/cles-acces/options": {
      "post": {
        "operationId": "optionsNouvelleCleAcces",
        "summary": "Préparer l'ajout d'une clé d'accès",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "Les options WebAuthn, avec leur défi.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OptionsCleAcces" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" }
        }
      }
    },
    "/compte/cles-acces/{cleAcces}": {
      "parameters": [{ "$ref": "#/components/parameters/CleAcces" }],
      "delete": {
        "operationId": "retirerCleAcces",
        "summary": "Retirer une clé d'accès",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/exports": {
      "get": {
        "operationId": "listerExports",
        "summary": "Lister les derniers exports demandés",
        "description": "Les cinq derniers, le plus récent d'abord : A21 les retrouve à chaque visite.",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "Les exports.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListeExports" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" }
        }
      },
      "post": {
        "operationId": "exporter",
        "summary": "Demander l'export de toutes les données",
        "description": "Par la session seule, au rôle gestion ; trois demandes par jour et par compte. L'archive se prépare, puis l'e-mail M15 en donne le lien, valable 7 jours, à qui l'a demandée. Elle ne nomme aucune faille d'un site sous un domaine non prouvé.",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "202": { "description": "L'export se prépare ; l'e-mail M15 prévient quand il est prêt.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Export" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "403": { "$ref": "#/components/responses/Interdit" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/exports/{export}": {
      "parameters": [{ "$ref": "#/components/parameters/Export" }],
      "get": {
        "operationId": "lireExport",
        "summary": "Lire un export",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "L'export, et son lien quand il est prêt.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Export" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      }
    },
    "/exports/{export}/archive": {
      "parameters": [{ "$ref": "#/components/parameters/Export" }],
      "get": {
        "operationId": "telechargerExport",
        "summary": "Télécharger l'archive d'un export",
        "description": "Avec la session (rôle gestion). Un export inconnu, pas encore prêt ou expiré répond 404, sans dire lequel.",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [{ "session": [] }],
        "responses": {
          "200": { "description": "L'archive JSON de toutes les données du compte (format manicou-export/1), sans secret : ni empreinte, ni en-tête de vérification, ni cible ni secret de canal, ni jeton de battement.", "content": { "application/json": { "schema": { "type": "object" } } } },
          "401": { "$ref": "#/components/responses/NonConnecte" },
          "404": { "$ref": "#/components/responses/Introuvable" }
        }
      },
      "post": {
        "operationId": "telechargerExportParLien",
        "summary": "Télécharger l'archive par le lien de l'e-mail",
        "description": "Sans session : le jeton du lien de M15, que la page `/archive` de l'espace client lit après `#` et envoie dans le corps. Il sert aussi après la fermeture du compte, et une seule fois : il s'efface quand l'archive est partie en entier, et un téléchargement coupé se refait. Un export inconnu, pas encore prêt, expiré, ou un jeton faux ou déjà servi répondent 404, sans dire lequel.",
        "tags": ["Réglages"],
        "x-ecrans": ["A21"],
        "security": [],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JetonDArchive" } } } },
        "responses": {
          "200": { "description": "L'archive JSON, comme `telechargerExport`.", "content": { "application/json": { "schema": { "type": "object" } } } },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sites/etat": {
      "get": {
        "operationId": "lireEtatSigne",
        "summary": "État signé d'une sonde, lu par sa recette chaque minute",
        "description": "Public : l'identifiant de la sonde ne se devine pas, et l'état ne dit rien que le site ne montre déjà (ni logiciel, ni version, ni numéro de faille). Signé à la lecture, gardé 60 secondes en cache, comme la 404 d'une sonde inconnue. Une adresse IP n'a que soixante identifiants inconnus par minute, pour l'état, le battement et l'archive ensemble ; au-delà, 429 une minute, sauf pour un site connu. La recette vérifie la signature, son domaine, sa sonde, l'expiration, et ignore un `numero` plus petit que le dernier vu. Depuis la 0.12.180, l'état se vérifie avant d'être signé, et un état dont la forme n'est pas celle qu'un garde accepte répond 503 `etat_non_signe`, l'exploitant prévenu (D-145).",
        "tags": ["Sites"],
        "x-ecrans": [],
        "security": [],
        "parameters": [{ "name": "sonde", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" } }],
        "responses": {
          "200": {
            "description": "L'état, signé au format Standard Webhooks (`v1a`, Ed25519).",
            "headers": {
              "webhook-id": { "$ref": "#/components/headers/webhook-id" },
              "webhook-timestamp": { "$ref": "#/components/headers/webhook-timestamp" },
              "webhook-signature": { "$ref": "#/components/headers/webhook-signature" }
            },
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EtatSigne" } } }
          },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/sites/accuses": {
      "post": {
        "operationId": "accuser",
        "summary": "Accusé d'application d'un ordre, envoyé par la recette",
        "description": "Public, et seulement indicatif : la protection compte quand le service la constate de l'extérieur.",
        "tags": ["Sites"],
        "x-ecrans": [],
        "security": [],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Accuse" } } } },
        "responses": {
          "204": { "$ref": "#/components/responses/Vide" },
          "404": { "$ref": "#/components/responses/Introuvable" },
          "422": { "$ref": "#/components/responses/Invalide" },
          "429": { "$ref": "#/components/responses/TropDeRequetes" }
        }
      }
    },
    "/b/{jeton}": {
      "servers": [{ "url": "/" }],
      "parameters": [{ "$ref": "#/components/parameters/JetonBattement" }],
      "get": {
        "operationId": "battreParGet",
        "summary": "Battement d'une tâche planifiée",
        "tags": ["Sites"],
        "x-ecrans": [],
        "security": [],
        "responses": { "204": { "$ref": "#/components/responses/Vide" }, "404": { "$ref": "#/components/responses/Introuvable" }, "429": { "$ref": "#/components/responses/TropDeRequetes" } }
      },
      "post": {
        "operationId": "battreParPost",
        "summary": "Battement d'une tâche planifiée",
        "tags": ["Sites"],
        "x-ecrans": [],
        "security": [],
        "responses": { "204": { "$ref": "#/components/responses/Vide" }, "404": { "$ref": "#/components/responses/Introuvable" }, "429": { "$ref": "#/components/responses/TropDeRequetes" } }
      },
      "head": {
        "operationId": "battreParHead",
        "summary": "Battement d'une tâche planifiée",
        "tags": ["Sites"],
        "x-ecrans": [],
        "security": [],
        "responses": { "204": { "$ref": "#/components/responses/Vide" }, "404": { "description": "Jeton inconnu." } }
      }
    },
    "/.well-known/manicou/cles.json": {
      "servers": [{ "url": "/" }],
      "get": {
        "operationId": "lireClesPubliques",
        "summary": "Les clés publiques qui signent les ordres",
        "tags": ["Sites"],
        "x-ecrans": [],
        "security": [],
        "responses": {
          "200": { "description": "Les clés en service ; une ancienne clé reste listée jusqu'à `jusqua`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClesPubliques" } } } }
        }
      }
    },
    "/entrees/github": {
      "post": {
        "operationId": "recevoirGithub",
        "summary": "Événements de l'application GitHub",
        "description": "Signés par GitHub (`X-Hub-Signature-256`) : un message mal signé est refusé. Un push relit, une minute après, la liste des sites reliés au dépôt, en une seule lecture pour tous et pour les autres pushes de cette minute. Au-delà de vingt lectures par minute pour une installation, la suivante attend cinq minutes.",
        "tags": ["Entrées"],
        "x-ecrans": [],
        "security": [],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Libre" } } } },
        "responses": { "204": { "$ref": "#/components/responses/Vide" }, "401": { "$ref": "#/components/responses/NonConnecte" } }
      }
    },
    "/entrees/paiement": {
      "post": {
        "operationId": "recevoirPaiement",
        "summary": "Événements du marchand",
        "description": "Signés par Paddle : un message mal signé est refusé. C'est le seul chemin qui active ou change une formule. Une transaction ne s'honore que si `choisirFormule` l'a créée, pour ce compte et cet article, et ce que dit son `custom_data` ne compte pas ; un abonnement en cours n'est jamais remplacé. Chaque événement ne compte qu'une fois (`event_id`), et un événement plus ancien que le dernier appliqué à l'abonnement (`occurred_at`) ne le change plus. Chaque événement d'abonnement se lit en entier, son statut compris, et celui qui arrive avant le paiement de son abonnement se garde pour lui. Une formule ne s'active que sur un abonnement et une période, avec le client du compte, sur un compte ouvert, et jamais à côté d'un abonnement qui court. Ce qui n'active rien se garde pour l'exploitant, et une signature refusée se compte (D-147).",
        "tags": ["Entrées"],
        "x-ecrans": [],
        "security": [],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Libre" } } } },
        "responses": { "204": { "$ref": "#/components/responses/Vide" }, "401": { "$ref": "#/components/responses/NonConnecte" } }
      }
    }
  },
  "webhooks": {
    "ordre": {
      "post": {
        "operationId": "envoyerOrdre",
        "summary": "Un ordre, envoyé à la recette d'un site en mode webhook",
        "description": "Signé au format Standard Webhooks, signature `v1a` (Ed25519), avec une clé publiée sous `/.well-known/manicou/cles.json`. Réessayé tant que le site ne répond pas `2xx`, jusqu'à l'expiration de l'ordre.",
        "parameters": [
          { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string" } },
          { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "integer" } },
          { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" } }
        ],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EtatSigne" } } } },
        "responses": { "200": { "description": "Reçu ; l'accusé d'application passe par `/sites/accuses`." } }
      }
    },
    "alerte": {
      "post": {
        "operationId": "envoyerAlerte",
        "summary": "Une alerte, envoyée à un canal webhook",
        "description": "Signée au format Standard Webhooks, signature `v1` (HMAC-SHA256 sur `id.horodatage.corps`), avec le secret de son canal, montré une fois à la création du canal ou à son renouvellement : la clé de Manicou ne la signe pas, et un receveur ne l'accepte que pour un canal dont il a le secret. Elle ne part qu'une fois l'adresse vérifiée (le webhook `verification`). `webhook-id` est l'identifiant stable de l'alerte, le même à chaque essai et à chaque renvoi, et pour une même cause (une panne, son site, son début et sa transition) : une alerte réécrite par Manicou ne part qu'une fois. Réessayée tant que le canal répond un code passager (le réseau, un délai, une redirection, `429`, `5xx`) : après 1, 5 et 30 minutes, 2 heures puis 6 heures, ou plus tard si `Retry-After` le demande, six heures au plus, six essais en tout, dix secondes au plus chacun, sans suivre de redirection. Un `410` casse le canal, et trois refus de suite (`4xx`) aussi : il ne reçoit plus que les essais, et le propriétaire du compte reçoit M18. Slack, Discord et Teams reçoivent le même contenu, au format de leurs webhooks entrants, et des pannes simultanées en un seul message ; un webhook générique, une alerte par site. Une échéance (`genre` à `echeance`) est datée (`le`) du jour où le certificat ou le domaine expire.",
        "parameters": [
          { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string" } },
          { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "integer" } },
          { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" } }
        ],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlerteWebhook" } } } },
        "responses": { "200": { "description": "Reçue : tout code `2xx` vaut accusé." } }
      }
    },
    "verification": {
      "post": {
        "operationId": "verifierUneAdresse",
        "summary": "Le défi de la vérification de l'adresse d'un webhook",
        "description": "L'extension « endpoint verification » de Standard Webhooks, avant la première alerte (verifierCanal). Signé comme une alerte, avec le secret du canal, il porte `webhook-challenge`, 32 octets tirés au hasard en base64. Le receveur répond 2xx avec `webhook-challenge-response` : « v1, » puis, en base64, HMAC-SHA256(cle_de_verification, defi), où cle_de_verification = HMAC-SHA256(cle, « wev-v1 ») et cle les octets du secret après « whsec_ », décodés du base64, et defi la valeur de l'en-tête telle que reçue. Recopier le défi ne suffit pas. Le corps ne se traite pas comme une alerte, et le receveur répond même s'il ne vérifie pas la signature. Dix secondes au plus, sans suivre de redirection.",
        "parameters": [
          { "name": "webhook-id", "in": "header", "required": true, "schema": { "type": "string" } },
          { "name": "webhook-timestamp", "in": "header", "required": true, "schema": { "type": "integer" } },
          { "name": "webhook-signature", "in": "header", "required": true, "schema": { "type": "string" } },
          { "name": "webhook-challenge", "in": "header", "required": true, "schema": { "type": "string" } }
        ],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["id", "genre", "le"], "properties": { "id": { "type": "string" }, "genre": { "type": "string", "enum": ["verification"] }, "le": { "$ref": "#/components/schemas/Date" } } } } } },
        "responses": { "200": { "description": "Accepté : tout code `2xx`, avec `webhook-challenge-response`.", "headers": { "webhook-challenge-response": { "description": "« v1, » puis la réponse au défi, en base64.", "schema": { "type": "string" } } } } }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "session": { "type": "apiKey", "in": "cookie", "name": "manicou_session", "description": "Posé à la connexion : `HttpOnly`, `Secure`, `SameSite=Strict`." },
      "cleApi": { "type": "http", "scheme": "bearer", "description": "Une clé d'API du compte (Réglages > API). Une clé limitée à un site (`CleApi.sonde`), celle d'une CI, ne sert qu'à `PUT /sondes/{sonde}/stack` de ce site, avec un fichier : toute autre route répond 403 `cle_limitee`, la même réponse que l'autre site existe ou non." }
    },
    "parameters": {
      "Sonde": { "name": "sonde", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" } },
      "Domaine": { "name": "domaine", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^dom_[0-9A-Za-z]{22}$" } },
      "Faille": { "name": "faille", "in": "path", "required": true, "description": "CVE, GHSA ou identifiant du CERT-FR.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{2,63}$" } },
      "Page": { "name": "page", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^pag_[0-9A-Za-z]{22}$" } },
      "NomPage": { "name": "nom", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{3,40}$" } },
      "Canal": { "name": "canal", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^can_[0-9A-Za-z]{22}$" } },
      "Cle": { "name": "cle", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^cle_[0-9A-Za-z]{22}$" } },
      "CleAcces": { "name": "cleAcces", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^cla_[0-9A-Za-z]{22}$" } },
      "Membre": { "name": "membre", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^mbr_[0-9A-Za-z]{22}$" } },
      "Invitation": { "name": "invitation", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^inv_[0-9A-Za-z]{22}$" } },
      "Fenetre": { "name": "fenetre", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^fen_[0-9A-Za-z]{22}$" } },
      "Ordre": { "name": "ordre", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^ord_[0-9A-Za-z]{22}$" } },
      "Envoi": { "name": "envoi", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^env_[0-9A-Za-z]{22}$" } },
      "Test": { "name": "test", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^tst_[0-9A-Za-z]{22}$" } },
      "Session": { "name": "session", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^ses_[0-9A-Za-z]{22}$" } },
      "Export": { "name": "export", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^exp_[0-9A-Za-z]{22}$" } },
      "JetonBattement": { "name": "jeton", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9A-Za-z]{22}$" } },
      "Apres": { "name": "apres", "in": "query", "description": "Le curseur `suivant` de la page précédente.", "schema": { "type": "string", "maxLength": 200 } },
      "Limite": { "name": "limite", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }
    },
    "headers": {
      "webhook-id": { "description": "L'identifiant unique du message, stable : le même à chaque essai et à chaque renvoi, et pour une même cause (une panne, son site, son début et sa transition). Un receveur écarte un doublon par lui.", "schema": { "type": "string" } },
      "webhook-timestamp": { "description": "Secondes depuis 1970, au moment de la signature.", "schema": { "type": "integer" } },
      "webhook-signature": { "description": "« v1a,<signature Ed25519 en base64> », sur « id.horodatage.corps ».", "schema": { "type": "string" } },
      "Set-Cookie": { "description": "La session : `manicou_session`, `HttpOnly`, `Secure`, `SameSite=Strict`.", "schema": { "type": "string" } }
    },
    "responses": {
      "Vide": { "description": "Fait." },
      "Accepte": { "description": "Accepté : la suite arrive par le journal, ou par e-mail." },
      "SessionOuverte": { "description": "Connecté.", "headers": { "Set-Cookie": { "$ref": "#/components/headers/Set-Cookie" } } },
      "NonConnecte": { "description": "Ni session, ni clé valable.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
      "Interdit": { "description": "Le rôle, la clé ou l'offre ne le permettent pas (`code` : `role_insuffisant`, `cle_en_lecture`, `cle_sans_ordres`, `cle_limitee`, `offre_insuffisante`, `domaine_non_prouve`).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
      "Introuvable": { "description": "N'existe pas, ou appartient à un autre compte.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
      "Conflit": { "description": "L'état a changé depuis l'écran, ou la ressource existe déjà.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
      "TropGros": { "description": "Fichier de plus de 10 Mo.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
      "Invalide": { "description": "Une entrée refusée ; `champs` dit lesquelles.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } },
      "TropDeRequetes": { "description": "Trop de requêtes ; `Retry-After` dit quand revenir.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Probleme" } } } }
    },
    "schemas": {
      "Probleme": {
        "type": "object",
        "required": ["title", "status", "code"],
        "properties": {
          "type": { "type": "string", "format": "uri" },
          "title": { "type": "string", "description": "Le problème, en une phrase." },
          "status": { "type": "integer" },
          "detail": { "type": "string" },
          "requete": { "type": "string", "description": "L'identifiant de la requête chez Cloudflare (son Ray ID), ajouté à chaque erreur : l'espace client le montre à copier, et le support retrouve la requête dans les journaux du Worker. Absent hors de Cloudflare." },
          "code": { "type": "string", "description": "Stable, pour le code : `entree_invalide`, `non_connecte`, `introuvable`, `role_insuffisant`, `cle_en_lecture`, `offre_insuffisante`, `domaine_non_prouve`, `conflit`, `trop_gros`, `trop_de_requetes`, `methode_refusee`, `erreur_interne`, `origine_refusee`, `ordres_indisponibles` (503, tant que les ordres signés, C22, manquent), `etat_non_signe` (503, un état du garde dont la forme n'est pas celle qu'un garde accepte, que Manicou ne signe pas), `github_indisponible`, `google_indisponible` (503, tant que l'application GitHub, C15, n'est pas créée), `signature_refusee` (401, un événement mal signé), `marchand_indisponible` (503 : le marchand ne répond pas, ou C27 manque encore), `abonnement_non_arrete` (503 : le marchand n'a pas arrêté l'abonnement, et le compte reste ouvert), `confirmer` (409 : un lien de connexion ouvert dans un autre navigateur, à confirmer), `cle_sans_ordres` (403 : une clé d'API sans le droit de donner des ordres), `cle_limitee` (403 : une clé limitée à un site, ailleurs que sur le dépôt de sa liste de logiciels), `precisions_epuisees` (409, un test gratuit dont les versions ont déjà été données trois fois), `createur_seul` (403, des versions données à un test gratuit sans son jeton), `deja_teste` (409, un site que le test gratuit vient de tester sous une autre origine), `mise_a_jour_refusee` (409, une mise à jour que Manicou ou GitHub refuse), `mise_a_jour_coupee` (503, l'interrupteur global de la mise à jour), `adresse_a_verifier` (409, un webhook dont l'adresse n'est pas vérifiée, qui ne reçoit rien, essai compris), `secret_manquant` (409, un webhook d'avant la 0.12.175, sans secret, dont l'adresse ne peut pas se vérifier) ; et, jusqu'au lancement, `acces_refuse` (403) : une requête sans le jeton de Cloudflare Access." },
          "champs": { "type": "array", "items": { "type": "object", "required": ["champ", "message"], "properties": { "champ": { "type": "string" }, "message": { "type": "string" }, "code": { "type": "string", "description": "La cause, stable, quand un champ se refuse pour plusieurs raisons : pour une adresse, `schema`, `identifiants` ou `privee` ; pour une version donnée au test gratuit, `logiciel` ou `version`." } } } }
        }
      },
      "RefusDeMiseAJour": {
        "type": "object",
        "description": "Un site dont la mise à jour n'est pas partie (D-115). Le journal du compte dit la même raison en une phrase.",
        "required": ["sonde", "raison"],
        "properties": {
          "sonde": { "type": "string" },
          "raison": {
            "type": "string",
            "enum": ["hors_kit", "version_format", "version_ancienne", "version_en_place_illisible", "workflow_absent", "workflow_desactive", "workflow_illisible", "sans_dispatch", "entree_absente", "entree_requise", "entree_refusee", "trop_long", "verrou_absent", "verrou_illisible", "hors_verrou", "node_version", "acces_refuse", "github_refuse", "github_muet", "imprevu"],
            "description": "Avant tout appel à GitHub, `hors_kit` (le workflow du kit ne met à jour que les paquets du verrou npm et Node) et `version_format`. Lu sur la branche par défaut, ce que le workflow refuserait (`sans_dispatch`, une entrée absente, requise ou refusée, `workflow_absent`, `workflow_desactive`, `workflow_illisible`) et ce que le script du kit refuserait (`verrou_absent`, `verrou_illisible`, `hors_verrou`, `version_ancienne`, `version_en_place_illisible`, `node_version`). Puis la réponse de GitHub, `github_refuse` pour un refus, `github_muet` quand il ne répond pas, `acces_refuse` quand l'application n'a pas accès au dépôt. `imprevu`, une erreur imprévue pendant la lecture du dépôt, qui compte pour l'arrêt de la mise à jour seule (D20)."
          },
          "detail": { "type": "string", "description": "L'entrée en cause, la réponse de GitHub, ou la version d'une copie en place." }
        }
      },
      "Libre": { "type": "object", "x-libre": true, "description": "Un message d'un service tiers, lu après la vérification de sa signature." },
      "Date": { "type": "string", "format": "date-time" },
      "DateOuRien": { "type": ["string", "null"], "format": "date-time" },
      "FaillePublique": {
        "type": "object",
        "description": "Une faille majeure, en public (S12) : exploitée ou critique.",
        "required": ["id", "titre", "exploitee", "correctif", "logiciels"],
        "properties": {
          "id": { "type": "string" },
          "titre": { "type": "string", "description": "Le titre de sa source : à afficher en texte." },
          "devant": { "type": ["string", "null"], "description": "Les logiciels à dire devant le titre quand il ne les nomme pas, trois au plus (« PHP » : « PHP · RCE via OOM corruption »)." },
          "severite": { "type": ["string", "null"], "enum": ["critique", "elevee", "moyenne", "faible", null] },
          "exploitee": { "type": "boolean" },
          "effet": { "type": ["string", "null"], "description": "Son effet, par ses familles (moteur/effets.ts) : prise_de_controle, base_de_donnees, fichiers_lus, acces_sans_droit, requetes_internes, script_injecte, action_a_la_place, fuite, indisponibilite, redirection." },
          "publieeLe": { "$ref": "#/components/schemas/DateOuRien" },
          "correctif": { "type": "boolean", "description": "Une version corrigée est publiée." },
          "logiciels": { "type": "array", "items": { "type": "string" }, "description": "Les noms de ses logiciels, dix au plus." }
        }
      },
      "FicheFaille": {
        "type": "object",
        "description": "La fiche d'une faille majeure, en public (S13) : ses versions, son correctif et ses sources.",
        "required": ["id", "titre", "exploitee", "correctif", "logiciels", "sources"],
        "properties": {
          "id": { "type": "string" },
          "alias": { "type": "array", "items": { "type": "string" } },
          "titre": { "type": "string" },
          "devant": { "type": ["string", "null"] },
          "severite": { "type": ["string", "null"] },
          "exploitee": { "type": "boolean" },
          "effet": { "type": ["string", "null"] },
          "publieeLe": { "$ref": "#/components/schemas/DateOuRien" },
          "correctif": { "type": "boolean" },
          "logiciels": { "type": "array", "items": { "type": "object", "required": ["nom", "touchees", "corrigee"], "properties": { "nom": { "type": "string" }, "touchees": { "type": "array", "items": { "type": "object", "properties": { "depuis": { "type": "string" }, "avant": { "type": "string" }, "jusqua": { "type": "string" } } } }, "corrigee": { "type": "array", "items": { "type": "string" } } } } },
          "sources": { "type": "array", "items": { "type": "object", "required": ["source", "noms", "vueLe"], "properties": { "source": { "type": "string", "enum": ["certfr", "osv", "kev", "editeur", "cve"] }, "noms": { "type": "object", "properties": { "fr": { "type": "string" }, "en": { "type": "string" } } }, "lien": { "type": ["string", "null"], "format": "uri" }, "vueLe": { "$ref": "#/components/schemas/Date" }, "licence": { "oneOf": [{ "$ref": "#/components/schemas/Licence" }, { "type": "null" }] } } } }
        }
      },
      "Licence": {
        "type": "object",
        "required": ["id", "auteur", "lien", "mention"],
        "description": "La licence de ce qu'une source publie (C32).",
        "properties": {
          "id": { "type": "string", "description": "L'identifiant SPDX : CC-BY-4.0, CC-BY-SA-4.0, CC0-1.0, Apache-2.0, MIT ou cve-tou (les conditions du programme CVE) ; « plusieurs » pour OSV." },
          "auteur": { "type": "string", "description": "À qui reviennent les données : « GitHub Advisory Database », « CISA », « The MITRE Corporation »." },
          "lien": { "type": "string", "format": "uri", "description": "Le texte de la licence ; pour OSV, sa liste des bases et de leurs licences." },
          "mention": { "type": ["string", "null"], "description": "À reproduire telle quelle avec chaque copie, comme la mention de MITRE pour la liste des CVE." }
        }
      },
      "Severite": { "type": "string", "enum": ["critique", "elevee", "moyenne", "faible"] },
      "Niveau": { "type": "string", "enum": ["normal", "restreint", "maintenance"] },
      "Certitude": { "type": "string", "enum": ["sure", "probable", "a_verifier"], "description": "`sure` : version lue dans une liste exacte ; `probable` : stack lue de l'extérieur ; `a_verifier` : version illisible, ou phrase que les règles ne savent pas lire." },
      "EtatSonde": { "type": "string", "enum": ["en_ligne", "en_panne", "inconnu", "en_pause", "maintenance_prevue"] },
      "Compteurs": {
        "type": "object",
        "required": ["critique", "elevee", "moyenne", "faible"],
        "properties": { "critique": { "type": "integer" }, "elevee": { "type": "integer" }, "moyenne": { "type": "integer" }, "faible": { "type": "integer" }, "inconnue": { "type": "integer", "description": "De gravité inconnue : aucune source ne la donne encore." } }
      },
      "Delais": {
        "type": "object",
        "description": "Médianes, en millisecondes, depuis la publication de la faille ; `null` tant qu'il n'y en a pas.",
        "properties": { "alerteMs": { "type": ["integer", "null"] }, "protectionMs": { "type": ["integer", "null"] }, "correctifMs": { "type": ["integer", "null"] } }
      },
      "Logiciel": {
        "type": "object",
        "required": ["nom", "version", "servi"],
        "properties": {
          "nom": { "type": "string" },
          "version": { "type": ["string", "null"] },
          "ecosysteme": { "type": "string", "enum": ["npm", "pypi", "packagist", "rubygems", "go", "maven", "nuget", "cargo", "langage", "cms", "serveur", "autre"] },
          "purl": { "type": ["string", "null"], "description": "L'identifiant de paquet (« pkg:npm/astro@5.1.0 »)." }, "produit": { "type": ["string", "null"], "description": "Le produit que nomment les avis de texte (« drupal » pour le paquet drupal/core) : la veille y cherche les avis du CERT-FR, de la CISA et des éditeurs ; null pour un paquet de groupe qu'elle ne sait pas nommer (OSV le connaît par son paquet)." },
          "servi": { "type": "boolean", "description": "Faux pour un outil qui ne sert qu'au build." },
          "donnee": { "type": "boolean", "description": "Vrai pour une version que le visiteur du test gratuit a donnée lui-même, la page ne la montrant pas." },
          "declaree": { "type": "boolean", "description": "Vrai pour une techno que le compte a déclarée lui-même : aucune lecture ne la remplace." },
          "suivi": { "type": "string", "enum": ["versions", "a_verifier", "exploitees"], "description": "Ce que la veille en suit : ses failles à sa version ; « à vérifier » le jour où la faille est publiée, par son éditeur ou par la liste des CVE, faute de version à comparer ; ou, pour un paquet sans version, ses seules failles exploitées, par la liste de la CISA, si elle le nomme." }
        }
      },
      "DemandeTest": {
        "type": "object",
        "additionalProperties": false,
        "required": ["adresse", "turnstile"],
        "properties": { "adresse": { "type": "string", "format": "uri", "maxLength": 2048 }, "turnstile": { "type": "string", "maxLength": 2048 } }
      },
      "Test": {
        "type": "object",
        "description": "Les failles se comptent par sévérité, sans leur nom : le détail demande un compte et un domaine prouvé.",
        "required": ["id", "adresse", "etat", "creeLe"],
        "properties": {
          "id": { "type": "string" },
          "adresse": { "type": "string" },
          "etat": { "type": "string", "enum": ["en_cours", "fini", "echec"] },
          "disponibilite": { "type": ["object", "null"], "properties": { "code": { "type": ["integer", "null"] }, "tempsMs": { "type": ["integer", "null"] }, "certificatExpireLe": { "$ref": "#/components/schemas/DateOuRien" } } },
          "stack": { "type": "array", "items": { "$ref": "#/components/schemas/Logiciel" } },
          "failles": { "$ref": "#/components/schemas/Compteurs" },
          "precisionsRestantes": { "type": "integer", "minimum": 0, "maximum": 3, "description": "Les fois où le visiteur peut encore donner des versions à ce test (preciserTest)." },
          "creeLe": { "$ref": "#/components/schemas/Date" },
          "jeton": { "type": "string", "description": "Dans la seule réponse de creerTest qui crée le test : ce que preciserTest demande. Ni une autre réponse ni lireTest ne le donnent." }
        }
      },
      "Lancement": {
        "type": "object",
        "description": "L'offre de lancement : ses places, et combien sont prises, jamais plus que les places.",
        "required": ["places", "prises"],
        "properties": {
          "places": { "type": "integer", "minimum": 0, "description": "100, les places du lancement. Leurs clients paient leur formule un tiers du prix, à vie, tant qu'ils la gardent." },
          "prises": { "type": "integer", "minimum": 0, "description": "Les comptes qui ont payé au prix du lancement, résiliés compris : une place prise le reste. Et les paiements au tiers du prix ouverts depuis moins de 10 minutes, qui tiennent chacun une place." }
        }
      },
      "EtatSources": {
        "type": "object",
        "required": ["sources"],
        "properties": {
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "required": ["nom", "etat"],
              "properties": {
                "nom": { "type": "string", "enum": ["osv", "kev", "cve", "github", "nodejs", "nginx", "apache", "tomcat", "php", "python", "ruby", "java", "dotnet", "microsoft", "openssl", "wordpress", "drupal", "joomla", "litespeed"] },
                "titre": { "type": "string" },
                "derniereLectureLe": { "$ref": "#/components/schemas/DateOuRien" },
                "etat": { "type": "string", "enum": ["a_jour", "en_retard", "muette"] },
                "licence": { "oneOf": [{ "$ref": "#/components/schemas/Licence" }, { "type": "null" }], "description": "Sa licence, à citer avec ce qu'on en montre ; « plusieurs » pour OSV, dont chaque avis garde celle de sa base ; null pour un éditeur, cité avec son lien." }
              }
            }
          }
        }
      },
      "Recette": {
        "type": "object",
        "required": ["type", "titre", "documentation", "modes"],
        "properties": {
          "type": { "type": "string", "enum": ["cloudflare", "node", "php", "nginx", "apache", "vercel", "netlify"] },
          "titre": { "type": "string" },
          "documentation": { "type": "string", "format": "uri" },
          "modes": { "type": "array", "minItems": 1, "items": { "type": "string", "enum": ["webhook", "lecture"] }, "description": "Comment le site reçoit ses ordres. Un seul (`lecture`, pour nginx et Apache) : A12 n'a pas d'étape « Le sens »." }
        }
      },
      "ListeRecettes": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Recette" } } } },
      "PagePublique": {
        "type": "object",
        "required": ["titre", "etat", "sondes", "mention"],
        "properties": {
          "titre": { "type": "string" },
          "etat": { "type": "string", "enum": ["operationnel", "degrade", "panne"], "description": "En panne si tous les sites vérifiés le sont, dégradé si certains ; un site en pause, en maintenance ou pas encore vérifié n'y compte pas." },
          "sondes": {
            "type": "array",
            "items": {
              "type": "object",
              "required": ["nom", "etat"],
              "properties": {
                "nom": { "type": "string" },
                "etat": { "$ref": "#/components/schemas/EtatSonde" },
                "disponibilite90j": { "type": ["number", "null"] },
                "jours": { "type": "array", "description": "Les 90 derniers jours, à l'heure du compte, le dernier en cours.", "items": { "type": "object", "properties": { "jour": { "type": "string", "format": "date" }, "disponibilite": { "type": ["number", "null"] } } } }
              }
            }
          },
          "incidents": { "type": "array", "maxItems": 10, "description": "Les pannes des 90 jours, les plus récentes d'abord, sous le nom du site.", "items": { "type": "object", "properties": { "sonde": { "type": "string" }, "debut": { "$ref": "#/components/schemas/Date" }, "fin": { "$ref": "#/components/schemas/DateOuRien" } } } },
          "maintenances": { "type": "array", "maxItems": 20, "description": "Les fenêtres de maintenance en cours, ou qui commencent dans les sept jours.", "items": { "type": "object", "properties": { "sonde": { "type": "string" }, "debut": { "$ref": "#/components/schemas/Date" }, "fin": { "$ref": "#/components/schemas/Date" } } } },
          "mention": { "type": "boolean", "description": "« Surveillé par Manicou »." },
          "logo": { "type": ["string", "null"], "description": "L'adresse du logo du client, sur cette origine ; null sans logo." },
          "majLe": { "$ref": "#/components/schemas/Date" },
          "fuseau": { "type": ["string", "null"], "description": "Le fuseau IANA du compte, où la page écrit ses heures." }
        }
      },
      "DemandeLien": {
        "type": "object",
        "additionalProperties": false,
        "required": ["email", "turnstile"],
        "properties": { "email": { "type": "string", "format": "email", "maxLength": 254 }, "turnstile": { "type": "string", "maxLength": 2048 } }
      },
      "Jeton": {
        "type": "object",
        "additionalProperties": false,
        "required": ["jeton"],
        "properties": { "jeton": { "type": "string", "maxLength": 200 }, "fuseau": { "type": "string", "maxLength": 64, "description": "Le fuseau IANA du navigateur, retenu à la création du compte seulement." } }
      },
      "JetonDArchive": {
        "type": "object",
        "additionalProperties": false,
        "required": ["jeton"],
        "properties": { "jeton": { "type": "string", "maxLength": 200, "description": "Le jeton du lien de M15, lu après `#`." } }
      },
      "JetonDeLien": {
        "type": "object",
        "additionalProperties": false,
        "required": ["jeton"],
        "properties": { "jeton": { "type": "string", "maxLength": 200 }, "fuseau": { "type": "string", "maxLength": 64, "description": "Le fuseau IANA du navigateur, retenu à la création du compte seulement." }, "confirme": { "type": "boolean", "description": "La personne a vu l'adresse du lien et la confirme : demandé quand le lien vient d'un autre navigateur." } }
      },
      "RetourGoogle": {
        "type": "object",
        "additionalProperties": false,
        "required": ["code", "etat"],
        "properties": { "code": { "type": "string", "maxLength": 2048 }, "etat": { "type": "string", "maxLength": 200 }, "fuseau": { "type": "string", "maxLength": 64, "description": "Le fuseau IANA du navigateur, retenu à la création du compte seulement." } }
      },
      "OptionsCleAcces": { "type": "object", "x-libre": true, "description": "Les options WebAuthn, telles que le navigateur les attend." },
      "ReponseCleAcces": { "type": "object", "x-libre": true, "description": "La réponse du navigateur (assertion ou attestation WebAuthn), telle quelle." },
      "CleAcces": {
        "type": "object",
        "required": ["id", "nom", "creeLe"],
        "properties": { "id": { "type": "string" }, "nom": { "type": "string" }, "creeLe": { "$ref": "#/components/schemas/Date" }, "dernierUsageLe": { "$ref": "#/components/schemas/DateOuRien" } }
      },
      "ListeClesAcces": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/CleAcces" } } } },
      "Moi": {
        "type": "object",
        "required": ["utilisateur", "comptes", "compteCourant"],
        "properties": {
          "utilisateur": { "type": "object", "required": ["id", "email", "nom"], "properties": { "id": { "type": "string" }, "email": { "type": "string", "format": "email" }, "nom": { "type": ["string", "null"], "description": "Celui que voient les autres membres." } } },
          "comptes": {
            "type": "array",
            "items": { "type": "object", "required": ["id", "nom", "role"], "properties": { "id": { "type": "string" }, "nom": { "type": "string" }, "role": { "type": "string", "enum": ["proprietaire", "gestion", "lecture"] } } }
          },
          "compteCourant": { "type": "string" },
          "menu": {
            "type": "object",
            "description": "Les compteurs de la barre latérale, pour le compte courant ; rien à l'écran à zéro.",
            "required": ["sitesEnPanne", "faillesOuvertes"],
            "properties": {
              "sitesEnPanne": { "type": "integer" },
              "faillesOuvertes": { "type": "integer", "description": "Le total de `Tableau.failles`." }
            }
          }
        }
      },
      "Banniere": {
        "type": "object",
        "required": ["genre"],
        "properties": {
          "genre": { "type": "string", "enum": ["faille_exploitee", "ordre_sans_accuse", "paiement_refuse", "preuve_perdue"] },
          "faille": { "type": "string", "description": "faille_exploitee : son identifiant." },
          "alias": { "type": "array", "items": { "type": "string" } },
          "titre": { "type": "string" },
          "devant": { "type": ["string", "null"], "description": "Le logiciel à écrire devant le titre, si le titre ne le dit pas." },
          "effet": {
            "type": ["string", "null"],
            "enum": ["prise_de_controle", "base_de_donnees", "fichiers_lus", "acces_sans_droit", "requetes_internes", "script_injecte", "action_a_la_place", "fuite", "indisponibilite", "redirection", null],
            "description": "faille_exploitee : l'effet de la faille en mots simples, celui de `Faille.effet`, que la phrase de la bannière dit : « Faille exploitée (prise de contrôle à distance), … ». null quand aucune famille connue ne le dit."
          },
          "exposes": { "type": "integer", "description": "Les sites sous un domaine prouvé qui restent exposés." },
          "abri": { "type": "boolean", "description": "Un de ces sites peut se mettre à l'abri tout de suite." },
          "sonde": { "type": "object", "description": "ordre_sans_accuse : le site.", "required": ["id", "nom"], "properties": { "id": { "type": "string" }, "nom": { "type": "string" } } },
          "domaine": { "type": "object", "description": "preuve_perdue : le domaine.", "required": ["id", "nom"], "properties": { "id": { "type": "string" }, "nom": { "type": "string" } } }
        }
      },
      "ChoixCompte": {
        "type": "object",
        "additionalProperties": false,
        "required": ["compte"],
        "properties": { "compte": { "type": "string", "pattern": "^cpt_[0-9A-Za-z]{22}$" } }
      },
      "LienSite": {
        "type": "object",
        "required": ["id", "nom"],
        "properties": { "id": { "type": "string" }, "nom": { "type": "string" } }
      },
      "LienDomaine": {
        "type": "object",
        "required": ["id", "nom"],
        "description": "Le domaine que vise un geste : « Prouver exemple.org » mène à A10.",
        "properties": {
          "id": { "type": ["string", "null"], "description": "null tant que le domaine n'est pas au compte : A10 part de son nom." },
          "nom": { "type": "string" }
        }
      },
      "AProuver": {
        "anyOf": [{ "$ref": "#/components/schemas/LienDomaine" }, { "type": "null" }],
        "description": "Le domaine à prouver pour que « Suis-je touché ? » réponde pour tous les sites du compte : « Prouvez exemple.org pour le savoir », vers A10. Non nul dès qu'une faille, de n'importe quelle sévérité, sûre ou à vérifier, reste à corriger sur un site sous un domaine non prouvé sans toucher aucun site sous un domaine prouvé : `masquees` de `listerFailles`, sur ces seules failles encore ouvertes. Le domaine : celui de la première ligne `a_prouver` d'`aTraiter` qui en porte un ; sans une telle ligne, le premier de ces domaines par son nom. Il se calcule pour tout le compte et ne dépend jamais de la faille montrée, sinon l'écart la désignerait. Il ne révèle rien de plus que le compte par sévérité, déjà public (S02). Un site sans domaine (un battement, une adresse IP) n'en donne aucun."
      },
      "SansDomaine": {
        "type": "integer",
        "minimum": 0,
        "description": "Le nombre de sites du compte qui ont des logiciels mais aucun domaine à prouver, une adresse IP ou un battement. Une faille ne s'y nomme jamais (ECRANS.md, Q1) : « Aucun de vos sites » ne vaut pas pour eux, et l'écran le dit. Il se calcule pour tout le compte et ne dépend jamais de la faille montrée, comme `aProuver`."
      },
      "LigneATraiter": {
        "type": "object",
        "description": "Une ligne d'« À traiter » : un site, son badge et son geste. Elle ne nomme jamais de faille : ni titre, ni logiciel, ni version. `faille` ne sert qu'à « Mettre à l'abri », qui n'existe que sous un domaine prouvé ; toute autre ligne l'a à `null`.",
        "required": ["sonde", "etat", "geste"],
        "properties": {
          "sonde": { "$ref": "#/components/schemas/LienSite" },
          "etat": { "type": "string", "enum": ["expose", "en_panne", "a_prouver"], "description": "Le badge : le plus grave du site, dans cet ordre. `a_prouver` : une faille exploitée ou critique le touche, sous un domaine non prouvé." },
          "depuis": { "$ref": "#/components/schemas/DateOuRien", "description": "« En panne, depuis 16:22 » ; null pour les autres états." },
          "geste": { "type": "string", "enum": ["poser_recette", "mettre_a_l_abri", "voir_protection", "voir_site", "prouver_domaine", "voir_formules", "passer_minute"], "description": "« Poser la recette » (A12) ; « Mettre à l'abri » (O03) ; « Voir » (A05, onglet Protection), pour un ordre sans accusé ou sans effet ; « Voir le site » (A05) ; « Prouver exemple.org » (A10), avec `domaine` ; « Voir les formules » (A20), un site exposé sous un domaine prouvé, dans un compte sans formule ; « Passer à la minute » (A05, onglet Réglages), un site exposé d'un compte qui a une formule, pas vérifié chaque minute (docs/PLAN.md §9)." },
          "domaine": { "anyOf": [{ "$ref": "#/components/schemas/LienDomaine" }, { "type": "null" }] },
          "faille": { "type": ["string", "null"], "description": "La faille que `mettre_a_l_abri` ouvre dans O03." }
        },
        "if": { "properties": { "geste": { "const": "mettre_a_l_abri" } } },
        "then": { "required": ["faille"], "properties": { "faille": { "type": "string" } } },
        "else": { "properties": { "faille": { "type": "null" } } }
      },
      "Tableau": {
        "type": "object",
        "required": ["sondes", "failles", "protections", "delais", "aTraiter", "suisJeTouche", "aProuver", "sansDomaine", "aFaire", "recents"],
        "properties": {
          "sondes": {
            "type": "object",
            "description": "Sites : `10 en ligne`, `1 en panne`, `1 en pause`. Une sonde en première vérification ou en maintenance prévue ne compte que dans `total` ; `total` à zéro mène à A01.",
            "required": ["total", "enLigne", "enPanne", "enPause"],
            "properties": { "total": { "type": "integer" }, "enLigne": { "type": "integer" }, "enPanne": { "type": "integer" }, "enPause": { "type": "integer" } }
          },
          "failles": {
            "description": "Failles ouvertes, par sévérité : pas encore corrigées, exposées ou protégées ; ni écartées, ni seulement à vérifier. Celles d'un site sous un domaine non prouvé y comptent, sans leur nom. À zéro : « Aucune ».",
            "allOf": [{ "$ref": "#/components/schemas/Compteurs" }, { "type": "object", "required": ["exploitees"], "properties": { "exploitees": { "type": "integer", "description": "Au moins une : la marque Exploitée." } } }]
          },
          "protections": { "type": "object", "properties": { "actives": { "type": "integer" } } },
          "delais": { "anyOf": [{ "$ref": "#/components/schemas/Delais" }, { "type": "null" }], "description": "« médianes sur 90 jours » ; null tant qu'aucun domaine du compte n'est protégé : le bloc verrouillé." },
          "aTraiter": {
            "type": "array",
            "description": "« À traiter » : un site par ligne, pour une faille exploitée ou critique encore ouverte, une panne, ou un ordre sans accusé ou sans effet ; dans l'ordre de `etat`, puis du nom du site, jamais d'après une faille. Vide : « Rien à traiter ».",
            "items": { "$ref": "#/components/schemas/LigneATraiter" }
          },
          "suisJeTouche": {
            "anyOf": [{ "$ref": "#/components/schemas/Faille" }, { "type": "null" }],
            "description": "« Suis-je touché ? » : toujours la dernière faille majeure publiée (critique ou exploitée), la même pour tous les comptes, que le compte ait ou non un site touché : en sauter une désignerait le site qu'elle touche. L'écran montre `effet`, `devant` et `titre`, `sitesParEtat`, puis la première réponse qui convient : `sondesTouchees` au-dessus de zéro, `3 de vos sites` ; `aProuver` non nul, « Prouvez exemple.org pour le savoir », vers A10 ; sinon, « Aucun de vos sites ». Ses comptes et ses dates ne lisent que les sites sous un domaine prouvé : une faille qui ne touche qu'un site sous un domaine non prouvé y répond comme une faille qui ne le touche pas. null : aucune faille majeure connue."
          },
          "aProuver": { "$ref": "#/components/schemas/AProuver" },
          "sansDomaine": { "$ref": "#/components/schemas/SansDomaine" },
          "aFaire": {
            "type": "array",
            "description": "« Mise en route », tant qu'elle n'est pas finie : une ligne par tâche (`3 à faire`). Vide : le bloc disparaît.",
            "items": {
              "type": "object",
              "required": ["genre", "titre", "sondes"],
              "properties": {
                "genre": { "type": "string", "enum": ["prouver_domaine", "poser_recette", "preciser_stack", "rafraichir_stack", "faille_a_verifier", "preuve_perdue"] },
                "titre": { "type": "string", "description": "Dans la langue du compte : « Poser la recette sur extranet.exemple.fr et sur docs.exemple.fr »." },
                "sondes": { "type": "array", "items": { "$ref": "#/components/schemas/LienSite" }, "description": "Les sites de cette tâche, chacun son lien." },
                "domaine": { "anyOf": [{ "$ref": "#/components/schemas/LienDomaine" }, { "type": "null" }] },
                "faille": { "type": ["string", "null"], "description": "Pour `faille_a_verifier`, qui n'existe que sous un domaine prouvé : ailleurs, ni cette ligne, ni le nom de la faille dans `titre`." }
              }
            }
          },
          "recents": { "type": "array", "maxItems": 5, "items": { "$ref": "#/components/schemas/EvenementJournal" }, "description": "Activité récente : les 5 dernières lignes du journal, chacune par son `court`." }
        }
      },
      "NouvelleSonde": {
        "type": "object",
        "additionalProperties": false,
        "required": ["type"],
        "description": "Une sonde HTTP(S) demande `adresse` ; un battement demande `periode`.",
        "properties": {
          "type": { "type": "string", "enum": ["http", "battement"] },
          "adresse": { "type": "string", "format": "uri", "maxLength": 2048 },
          "nom": { "type": "string", "maxLength": 100, "description": "Tiré de l'adresse s'il manque." },
          "intervalle": { "type": "integer", "enum": [60, 300], "description": "En secondes : 300 en gratuit, 60 sur un domaine payé." },
          "methode": { "type": "string", "enum": ["GET", "HEAD", "POST"], "default": "GET" },
          "entetes": { "type": "object", "maxProperties": 20, "additionalProperties": { "type": "string", "maxLength": 1000 } },
          "motAttendu": { "type": "string", "maxLength": 200 },
          "codesAttendus": { "type": "array", "maxItems": 20, "items": { "type": "integer", "minimum": 100, "maximum": 599 }, "description": "Par défaut : 200 à 399." },
          "periode": { "type": "integer", "minimum": 60, "maximum": 2592000, "description": "Battement : secondes attendues entre deux appels." }
        }
      },
      "NouvellesSondes": {
        "type": "object",
        "additionalProperties": false,
        "required": ["sondes"],
        "properties": { "sondes": { "type": "array", "minItems": 1, "maxItems": 50, "items": { "$ref": "#/components/schemas/NouvelleSonde" } } }
      },
      "SondesCreees": { "type": "object", "required": ["sondes"], "properties": { "sondes": { "type": "array", "items": { "$ref": "#/components/schemas/Sonde" } } } },
      "ModifSonde": {
        "type": "object",
        "additionalProperties": false,
        "minProperties": 1,
        "properties": {
          "nom": { "type": "string", "maxLength": 100 },
          "intervalle": { "type": "integer", "enum": [60, 300] },
          "methode": { "type": "string", "enum": ["GET", "HEAD", "POST"] },
          "entetes": { "type": "object", "description": "Remplace tous les en-têtes. Une valeur null garde celle d'aujourd'hui.", "maxProperties": 20, "additionalProperties": { "type": ["string", "null"], "maxLength": 1000 } },
          "motAttendu": { "type": ["string", "null"], "maxLength": 200 },
          "codesAttendus": { "type": "array", "maxItems": 20, "items": { "type": "integer", "minimum": 100, "maximum": 599 } },
          "periode": { "type": "integer", "minimum": 60, "maximum": 2592000 },
          "pause": { "type": "boolean" }
        }
      },
      "Sonde": {
        "type": "object",
        "required": ["id", "type", "nom", "etat", "pause", "creeLe"],
        "properties": {
          "id": { "type": "string" },
          "type": { "type": "string", "enum": ["http", "battement"] },
          "nom": { "type": "string" },
          "adresse": { "type": ["string", "null"] },
          "intervalle": { "type": ["integer", "null"] },
          "methode": { "type": ["string", "null"] },
          "motAttendu": { "type": ["string", "null"] },
          "codesAttendus": { "type": "array", "items": { "type": "integer" } },
          "etat": { "$ref": "#/components/schemas/EtatSonde" },
          "etatDepuis": { "$ref": "#/components/schemas/DateOuRien" },
          "pause": { "type": "boolean", "description": "Vrai aussi pour un site suspendu." },
          "suspendu": { "type": "boolean", "description": "En pause par Manicou, et non par le compte, au-delà des sites actifs que compte l'offre, 50 sans formule et 50 de plus que les sites à la minute de la formule avec elle. Le retour d'une formule le reprend, les plus anciens d'abord, et le compte peut le reprendre lui-même en mettant en pause un site actif (D-147)." },
          "domaine": {
            "type": ["object", "null"],
            "description": "Le domaine qui le porte : le bloc verrouillé d'A05 et d'A12 (« Prouvez exemple.org pour protéger ce site »). null pour un battement.",
            "properties": {
              "id": { "type": ["string", "null"], "description": "null tant que ce domaine n'est pas au compte : `nom` est alors le domaine enregistrable de son adresse, et `prouve` est faux." },
              "nom": { "type": "string" },
              "prouve": { "type": "boolean" },
              "protege": { "type": "boolean", "description": "Sa protection est active (`Domaine.protection.active`)." }
            }
          },
          "protection": {
            "type": "object",
            "properties": {
              "niveau": { "$ref": "#/components/schemas/Niveau" },
              "recettePosee": { "type": "boolean" },
              "recette": { "type": ["string", "null"], "description": "Son hébergeur : cloudflare, nginx…" },
              "etat": { "type": ["string", "null"], "enum": ["aucune_faille", "protege", "expose", "a_prouver", null], "description": "La bannière d'A05 et la colonne d'A03 : « Aucune faille connue », « Protégé, pas encore corrigé », « Exposé », « À prouver » ; null pour un battement. `protege` : « Lever » demande une confirmation." }
            }
          },
          "failles": { "$ref": "#/components/schemas/Compteurs" },
          "exploitee": { "type": "boolean", "description": "Une faille ouverte sur ce site est exploitée. Toujours faux sous un domaine non prouvé." },
          "barres24h": { "type": "array", "description": "Seulement dans la liste : la disponibilité de chaque heure des dernières 24 heures, en %, à l'heure du compte ; null : pas surveillé.", "items": { "type": ["number", "null"] } },
          "entetes": { "type": "array", "description": "Les noms des en-têtes envoyés : leurs valeurs ne se relisent jamais.", "items": { "type": "string" } },
          "disponibilite30j": { "type": ["number", "null"], "minimum": 0, "maximum": 100, "description": "En %, au millième, arrondie par défaut : la part du temps surveillé des 30 derniers jours, à l'heure du compte, sans panne confirmée. Le temps en pause ne compte pas ; `null` si rien n'a été surveillé." },
          "tempsMs": { "type": ["integer", "null"], "description": "Le temps de réponse moyen des vérifications réussies des dernières 24 heures ; `null` pour un battement, ou s'il est inconnu." },
          "echeances": {
            "type": ["object", "null"],
            "description": "Pour une sonde HTTP(S) : le certificat que sert son hôte (une adresse `https` seulement) et le domaine qui le porte, lus dès la minute qui suit sa création, puis chaque jour ; `null` pour un battement. Chacune est `null` tant qu'elle n'a pas été lue ; une adresse IP n'a pas de domaine.",
            "required": ["certificat", "domaine"],
            "properties": { "certificat": { "$ref": "#/components/schemas/Echeance" }, "domaine": { "$ref": "#/components/schemas/Echeance" } }
          },
          "battement": { "type": ["object", "null"], "properties": { "adresse": { "type": ["string", "null"], "format": "uri", "description": "L'adresse à appeler, qui porte le jeton du battement : null pour le rôle lecture." }, "periode": { "type": "integer" }, "dernierLe": { "$ref": "#/components/schemas/DateOuRien" } } },
          "creeLe": { "$ref": "#/components/schemas/Date" }
        }
      },
      "Echeance": {
        "type": ["object", "null"],
        "description": "Une échéance d'un site (C7). L'alerte M05 part à 14, 7 et 3 jours de celle d'un certificat, à 30 et 7 jours de celle d'un domaine, une fois par seuil pour une même date.",
        "required": ["nom", "source", "expireLe", "emetteur", "raison", "luLe"],
        "properties": {
          "nom": { "type": "string", "description": "L'hôte, suivi de son port s'il n'est pas 443, pour un certificat ; le domaine, pour un domaine." },
          "source": { "type": "string", "enum": ["serveur", "cloudflare", "registre"], "description": "`serveur` : le certificat que sert le site, lu par une poignée de main TLS ; `cloudflare` : le site est servi par Cloudflare, qui gère et renouvelle son certificat, sans date à lire ; `registre` : l'échéance du domaine, au registre (RDAP)." },
          "expireLe": { "$ref": "#/components/schemas/DateOuRien" },
          "emetteur": { "type": ["string", "null"], "description": "L'autorité qui a émis le certificat (« Let's Encrypt »)." },
          "raison": { "type": ["string", "null"], "description": "Pourquoi la dernière lecture a échoué, en une phrase fixe ; la date d'avant reste. Pour un certificat : « adresse refusée », « adresse introuvable », « connexion impossible », « connexion coupée », « délai dépassé », « poignée de main refusée », « réponse illisible ». Pour un domaine : « extension sans registre RDAP », « domaine inconnu du registre », « échéance absente au registre », « registre muet », « réponse illisible »." },
          "luLe": { "$ref": "#/components/schemas/DateOuRien" }
        }
      },
      "PageSondes": {
        "type": "object",
        "required": ["elements", "suivant"],
        "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Sonde" } }, "suivant": { "type": ["string", "null"] }, "total": { "type": "integer", "description": "Tous les sites du compte, filtres à part." }, "limite": { "type": "integer", "description": "Le nombre de sites que le compte peut avoir : 50 à 5 minutes, et ceux de sa formule à la minute." }, "limites": { "type": "object", "description": "Le compteur d'A03 : ses sites à 5 minutes et à la minute, et ce que le compte en garde.", "required": ["gratuits", "minute"], "properties": { "gratuits": { "$ref": "#/components/schemas/Compteur" }, "minute": { "$ref": "#/components/schemas/Compteur" } } } }
      },
      "Lot": {
        "type": "object",
        "additionalProperties": false,
        "required": ["sondes", "action"],
        "properties": {
          "sondes": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" } },
          "action": { "type": "string", "enum": ["pause", "reprise", "intervalle", "supprimer"] },
          "intervalle": { "type": "integer", "enum": [60, 300] }
        }
      },
      "ResultatLot": { "type": "object", "required": ["modifiees"], "properties": { "modifiees": { "type": "integer" } } },
      "Incident": {
        "type": "object",
        "required": ["id", "debut", "cause"],
        "properties": {
          "id": { "type": "string" },
          "debut": { "$ref": "#/components/schemas/Date" },
          "fin": { "$ref": "#/components/schemas/DateOuRien" },
          "cause": { "type": "string", "description": "Une phrase fixe, jamais tirée de la page : « code 503 » (tout code inattendu), « délai dépassé », « connexion impossible », « connexion coupée », « mot attendu absent », « battement manqué », « réglages refusés »." },
          "regions": { "type": "array", "items": { "type": "string" }, "description": "Les régions qui ont vu la panne." }
        }
      },
      "Mesures": {
        "type": "object",
        "required": ["periode", "disponibilite", "points", "incidents"],
        "properties": {
          "periode": { "type": "string", "enum": ["24h", "7j", "30j", "90j"] },
          "disponibilite": { "type": ["number", "null"], "minimum": 0, "maximum": 100, "description": "En %, au millième, arrondie par défaut : la part du temps surveillé de la période sans panne confirmée depuis deux régions. Le temps en pause ne compte ni en ligne ni en panne ; une fenêtre de maintenance compte comme le reste, puisqu'aucune panne n'y commence. `null` si rien n'a été surveillé." },
          "tempsMoyenMs": { "type": ["integer", "null"], "description": "Le temps de réponse moyen des vérifications réussies de la période ; `null` pour un battement, ou s'il est inconnu." },
          "points": { "type": "array", "description": "Une tranche par heure ou par jour, dans l'ordre. Sa disponibilité vaut `null` avant la création de la sonde, en pause, ou quand la période a trop de pannes pour être lue tranche par tranche.", "items": { "type": "object", "required": ["debut"], "properties": { "debut": { "$ref": "#/components/schemas/Date" }, "disponibilite": { "type": ["number", "null"], "minimum": 0, "maximum": 100 }, "tempsMs": { "type": ["integer", "null"] } } } },
          "incidents": { "type": "array", "maxItems": 100, "description": "Les pannes qui touchent la période, les plus récentes d'abord, 100 au plus.", "items": { "$ref": "#/components/schemas/Incident" } }
        }
      },
      "Stack": {
        "type": "object",
        "required": ["origine", "etat", "logiciels", "aRafraichir"],
        "properties": {
          "origine": { "type": "string", "enum": ["exterieur", "questions", "github", "fichier", "ci"] },
          "etat": { "type": "string", "enum": ["lue", "en_lecture", "echec"] },
          "relueLe": { "$ref": "#/components/schemas/DateOuRien" },
          "aRafraichir": { "type": "boolean", "description": "Vrai si la liste n'a pas été relue depuis 30 jours." },
          "depot": { "type": ["object", "null"], "properties": { "installation": { "type": "integer" }, "nom": { "type": "string" }, "repli": { "type": "boolean", "description": "Le graphe de dépendances est coupé : la liste vient des fichiers de verrouillage (A06)." } } },
          "logiciels": { "type": "array", "items": { "$ref": "#/components/schemas/Logiciel" } },
          "avertissements": { "type": "array", "items": { "type": "string" }, "maxItems": 21, "description": "Rendu au dépôt d'un fichier seulement, quand sa lecture a dû écarter ou regrouper. Les composants écartés, leur nom illisible ou démesuré. Au-delà de 50 versions d'un même paquet, les autres lues ensemble comme une version inconnue, que la veille met « à vérifier » (D-130)." }
        }
      },
      "ReponsesStack": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "hebergeur": { "type": "string", "maxLength": 100 },
          "serveur": { "type": "string", "enum": ["nginx", "apache", "iis", "caddy", "litespeed", "autre", "inconnu"] },
          "langage": {
            "type": "object",
            "additionalProperties": false,
            "required": ["nom"],
            "properties": { "nom": { "type": "string", "enum": ["php", "node", "python", "ruby", "java", "dotnet", "go", "autre"] }, "version": { "type": "string", "maxLength": 40 } }
          },
          "cms": {
            "type": "object",
            "additionalProperties": false,
            "required": ["nom"],
            "properties": { "nom": { "type": "string", "enum": ["wordpress", "drupal", "joomla", "prestashop", "magento", "autre"] }, "version": { "type": "string", "maxLength": 40 } }
          }
        }
      },
      "DepotGithub": {
        "type": "object",
        "additionalProperties": false,
        "required": ["installation", "depot"],
        "properties": { "installation": { "type": "integer" }, "depot": { "type": "string", "maxLength": 200, "description": "« propriétaire/nom »." } }
      },
      "NouvelleStack": {
        "oneOf": [
          { "type": "object", "additionalProperties": false, "required": ["questions"], "properties": { "questions": { "$ref": "#/components/schemas/ReponsesStack" } } },
          { "type": "object", "additionalProperties": false, "required": ["github"], "properties": { "github": { "$ref": "#/components/schemas/DepotGithub" } } }
        ]
      },
      "NouvellesTechnos": {
        "type": "object",
        "additionalProperties": false,
        "required": ["technos"],
        "properties": {
          "technos": {
            "type": "array",
            "maxItems": 100,
            "description": "Toutes les technos déclarées du site : elles remplacent les précédentes, et une liste vide les retire. Deux versions du même logiciel font deux lignes.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": ["nom"],
              "properties": {
                "nom": { "type": "string", "minLength": 1, "maxLength": 100, "description": "Le nom du logiciel, tel qu'on l'écrit (« PostgreSQL », « Cisco ASA »). Une version à sa suite (« PostgreSQL 16 ») se lit comme sa version." },
                "version": { "type": "string", "maxLength": 40 }
              }
            }
          }
        }
      },
      "FichierStack": {
        "type": "object",
        "additionalProperties": false,
        "required": ["fichier"],
        "properties": { "fichier": { "type": "string", "contentMediaType": "application/octet-stream", "description": "SBOM CycloneDX ou SPDX (JSON), ou fichier de verrouillage (package-lock.json, composer.lock…), 10 Mo au plus." } }
      },
      "Atteinte": {
        "type": "object",
        "description": "Un logiciel d'un site, touché par une faille. Les six points de la chaîne d'A08 sont `alerteLe`, `ordreLe`, `protegeeLe`, `verifieeLe`, `miseAJour.lanceeLe` et `corrigeeLe` : `null` tant que l'étape n'a pas eu lieu.",
        "required": ["faille", "sonde", "logiciel", "certitude", "protection"],
        "properties": {
          "faille": {
            "type": "object",
            "required": ["id", "titre", "severite", "exploitee"],
            "properties": {
              "id": { "type": "string" },
              "titre": { "type": "string" },
              "severite": { "anyOf": [{ "$ref": "#/components/schemas/Severite" }, { "type": "null" }] },
              "exploitee": { "type": "boolean" },
              "effet": {
                "type": ["string", "null"],
                "enum": ["prise_de_controle", "base_de_donnees", "fichiers_lus", "acces_sans_droit", "requetes_internes", "script_injecte", "action_a_la_place", "fuite", "indisponibilite", "redirection", null],
                "description": "L'effet de la faille en mots simples, celui de `Faille.effet`, au-dessus de son titre dans l'onglet Failles d'A05. null quand aucune famille connue ne le dit."
              }
            }
          },
          "sonde": { "type": "object", "required": ["id", "nom"], "properties": { "id": { "type": "string" }, "nom": { "type": "string" }, "adresse": { "type": ["string", "null"] }, "recettePosee": { "type": "boolean", "description": "Sinon, le geste de la ligne : « Poser la recette »." }, "workflowPose": { "type": "boolean", "description": "Le workflow de mise à jour." } } },
          "logiciel": { "type": "object", "required": ["nom"], "properties": { "nom": { "type": "string" }, "libelle": { "type": "string", "description": "Son nom à l'écran : « PHP »." }, "version": { "type": ["string", "null"] }, "corrigee": { "type": "array", "items": { "type": "string" }, "description": "Ce qui corrige cette version : `PHP 8.3.30 → 8.3.36`, dans la ligne dépliée." } } },
          "certitude": { "$ref": "#/components/schemas/Certitude" },
          "motif": {
            "type": ["string", "null"],
            "enum": ["version_inconnue", "version_illisible", "version_de_distribution", "ordre_inconnu", "borne_illisible", "numerotation_inconnue", "plage_par_commits", "avis_ambigu", "avis_demesure", "sans_version", "lecture_incertaine", "nom_incertain", null],
            "description": "Pourquoi Manicou ne tranche pas, pour une atteinte de certitude a_verifier, dans la ligne dépliée d'A08 et dans l'e-mail M07 (D-125). La version du site d'abord (inconnue, illisible dans la numérotation de son écosystème, ou celle d'une distribution), puis la source (une borne illisible, une numérotation sans comparateur, des commits seulement, des événements dans le désordre qui se lisent de deux façons, un avis trop long, aucune version citée, une phrase lue sans certitude, un nom écrit autrement), enfin deux versions lisibles que rien ne permet de ranger. null pour une atteinte sûre ou probable, et pour une atteinte gardée avant la 0.12.154."
          },
          "etat": { "type": "string", "enum": ["exposee", "protegee", "corrigee", "ecartee", "a_verifier"], "description": "Le badge de la ligne d'A08. protegee : protection en place, pas encore corrigée." },
          "protection": { "type": "object", "properties": { "niveau": { "$ref": "#/components/schemas/Niveau" }, "depuis": { "$ref": "#/components/schemas/DateOuRien" } } },
          "alerteLe": { "$ref": "#/components/schemas/DateOuRien" },
          "ordreLe": { "$ref": "#/components/schemas/DateOuRien", "description": "L'ordre envoyé à ce site pour cette faille : jamais, sans recette." },
          "protegeeLe": { "$ref": "#/components/schemas/DateOuRien", "description": "Le site dit avoir appliqué la protection." },
          "verifieeLe": { "$ref": "#/components/schemas/DateOuRien", "description": "L'effet constaté de l'extérieur." },
          "miseAJour": { "type": ["object", "null"], "required": ["lanceeLe"], "properties": { "lanceeLe": { "$ref": "#/components/schemas/Date" }, "lien": { "type": ["string", "null"], "format": "uri", "description": "Son exécution chez GitHub : « Suivre le workflow »." } } },
          "corrigeeLe": { "$ref": "#/components/schemas/DateOuRien" },
          "leveeLe": { "$ref": "#/components/schemas/DateOuRien" },
          "ecart": { "anyOf": [{ "$ref": "#/components/schemas/EcartFait" }, { "type": "null" }] }
        }
      },
      "PageAtteintes": {
        "type": "object",
        "required": ["elements", "suivant"],
        "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Atteinte" } }, "suivant": { "type": ["string", "null"] }, "masquees": { "anyOf": [{ "$ref": "#/components/schemas/Compteurs" }, { "type": "null" }], "description": "Un site sous aucun domaine prouvé : ses failles comptées par sévérité, sans leur nom, et aucun élément ; null sinon." } }
      },
      "Faille": {
        "type": "object",
        "required": ["id", "titre", "severite", "exploitee", "sources", "vueLe", "sondesTouchees", "etat"],
        "properties": {
          "id": { "type": "string", "description": "CVE, GHSA ou identifiant du CERT-FR." },
          "alias": { "type": "array", "items": { "type": "string" } },
          "titre": { "type": "string", "description": "Texte de la source : à afficher en texte, jamais en HTML." },
          "severite": { "anyOf": [{ "$ref": "#/components/schemas/Severite" }, { "type": "null" }], "description": "Son impact seulement, d'après ses sources (D-128). Exploitée, elle le dit par exploitee, qui la met en tête de l'ordre sans changer sa gravité. null, une gravité inconnue, qu'aucune source ne donne encore." },
          "exploitee": { "type": "boolean", "description": "Sur la liste de la CISA, dite exploitée par le point SSVC que la CISA ajoute à sa fiche CVE, ou par sa source (D-128)." },
          "sources": { "type": "array", "items": { "type": "string", "enum": ["certfr", "osv", "kev", "editeur", "cve"] } },
          "publieeLe": { "$ref": "#/components/schemas/DateOuRien" },
          "vueLe": { "$ref": "#/components/schemas/Date" },
          "sondesTouchees": { "type": "integer", "description": "Sous un domaine prouvé seulement." },
          "etat": { "type": "string", "enum": ["ouverte", "protegee", "corrigee", "a_verifier", "ecartee", "non_touchee"], "description": "L'onglet d'A07. ouverte : un site du compte reste exposé ; protegee : plus aucun, mais un site n'est pas encore corrigé ; a_verifier : ses sites ne sont qu'à vérifier ; non_touchee : aucun site du compte sous un domaine prouvé (lireFaille, `Tableau.suisJeTouche`) ; avec `aProuver` non nul, cette réponse n'est pas complète." },
          "logicielsTouches": { "type": "array", "items": { "type": "string" }, "description": "Les logiciels à l'écran, sur les sites du compte sous un domaine prouvé ; ceux où la faille est sûre d'abord, trois au plus. La colonne d'A07." },
          "devant": { "type": ["string", "null"], "description": "Ce qui précède le titre sur A08 : `PHP · RCE via OOM corruption`. null quand le titre le dit déjà (`Node.js : HashDoS in V8`). Il vient de la faille, jamais des sites du compte." },
          "effet": {
            "type": ["string", "null"],
            "enum": ["prise_de_controle", "base_de_donnees", "fichiers_lus", "acces_sans_droit", "requetes_internes", "script_injecte", "action_a_la_place", "fuite", "indisponibilite", "redirection", null],
            "description": "L'effet de la faille en mots simples, que l'écran écrit au-dessus du titre de la source sur A02, A05, A07 et A08 (`prise_de_controle`, « Prise de contrôle à distance »), comme la bannière d'une faille exploitée et les e-mails M06 et M07. Il se déduit de ses familles (CWE), lues aux sources qui les donnent, par une table de règles sans modèle d'IA (moteur/effets.ts). Plusieurs familles donnent l'effet le plus grave, dans l'ordre de cette liste. null quand aucune famille connue ne le dit. Il vient de la faille, jamais des sites du compte."
          },
          "correctif": { "type": "boolean", "description": "Une source donne une version corrigée : « Correctif publié », ou « Pas encore de correctif »." },
          "sitesParEtat": { "type": "object", "description": "Le compte des sites, en pastilles, sous un domaine prouvé seulement.", "properties": { "exposes": { "type": "integer" }, "proteges": { "type": "integer" }, "corriges": { "type": "integer" }, "ecartes": { "type": "integer" }, "aVerifier": { "type": "integer" } } },
          "alerteLe": { "$ref": "#/components/schemas/DateOuRien", "description": "La première alerte du compte, pour un site sous un domaine prouvé : « ouverte depuis 49 min », sur A07." },
          "protectionMs": { "type": ["integer", "null"], "description": "Médiane depuis l'alerte, sur les sites protégés sous un domaine prouvé : « protégé en 3 min », sur A07." },
          "correctifMs": { "type": ["integer", "null"], "description": "Médiane depuis l'alerte, sur les sites corrigés sous un domaine prouvé : « corrigé en 1 h 12 », sur A07." },
          "ecart": { "anyOf": [{ "$ref": "#/components/schemas/EcartFait" }, { "type": "null" }], "description": "Le badge `Écartée : non touché` d'A08, sous un domaine prouvé seulement." }
        }
      },
      "Ecart": {
        "type": "object",
        "additionalProperties": false,
        "required": ["raison"],
        "properties": { "raison": { "type": "string", "enum": ["non_touche", "risque_accepte"] } }
      },
      "EcartFait": {
        "type": "object",
        "required": ["raison", "par", "le"],
        "properties": {
          "raison": { "type": "string", "enum": ["non_touche", "risque_accepte"] },
          "par": { "type": ["string", "null"], "description": "L'adresse de son auteur, dont le rôle lecture ne lit que le domaine (« •••@exemple.fr ») ; null pour une clé d'API." },
          "le": { "$ref": "#/components/schemas/Date" }
        }
      },
      "PageFailles": {
        "type": "object",
        "required": ["elements", "suivant"],
        "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Faille" } }, "suivant": { "type": ["string", "null"] }, "parEtat": { "type": "object", "description": "Les nombres des onglets d'A07, avec les mêmes filtres, sauf `etat`.", "required": ["ouverte", "protegee", "a_verifier", "ecartee", "corrigee"], "properties": { "ouverte": { "type": "integer" }, "protegee": { "type": "integer" }, "a_verifier": { "type": "integer" }, "ecartee": { "type": "integer" }, "corrigee": { "type": "integer" } } }, "masquees": { "$ref": "#/components/schemas/Compteurs", "description": "Les failles qui ne touchent que des sites sous aucun domaine prouvé : comptées par sévérité, sans leur nom (ECRANS.md, Q1)." } }
      },
      "FailleDetail": {
        "allOf": [
          { "$ref": "#/components/schemas/Faille" },
          {
            "type": "object",
            "required": ["logiciels", "atteintes"],
            "properties": {
              "resume": { "type": ["string", "null"], "description": "Texte de la source, sur une ligne : à afficher en texte." },
              "liens": { "type": "array", "items": { "type": "string", "format": "uri" } },
              "publications": {
                "type": "array",
                "description": "Les sources de « Détails », chacune avec son heure. Leur texte : à afficher en texte, jamais en HTML.",
                "items": {
                  "type": "object",
                  "required": ["source", "vueLe"],
                  "properties": {
                    "source": { "type": "string", "enum": ["certfr", "osv", "kev", "editeur", "cve"] },
                    "nom": { "type": "string", "description": "« Avis de PHP sur GitHub », ou le nom d'hôte de son lien quand il ne mène pas chez sa source." },
                    "lien": { "type": ["string", "null"], "format": "uri" },
                    "vueLe": { "$ref": "#/components/schemas/Date" },
                    "texte": { "type": ["string", "null"], "description": "Ce que dit la source, en brut et dans sa langue." },
                    "licence": { "oneOf": [{ "$ref": "#/components/schemas/Licence" }, { "type": "null" }], "description": "La licence de ce qu'elle publie, à citer avec son texte ; null pour l'avis d'un éditeur, cité avec son lien." }
                  }
                }
              },
              "logiciels": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "nom": { "type": "string" },
                    "touchees": { "type": "array", "items": { "type": "object", "properties": { "depuis": { "type": "string" }, "avant": { "type": "string" }, "jusqua": { "type": "string" } } } },
                    "corrigee": { "type": "array", "items": { "type": "string" } }
                  }
                }
              },
              "atteintes": { "type": "array", "items": { "$ref": "#/components/schemas/Atteinte" } },
              "delais": { "$ref": "#/components/schemas/Delais" },
              "aProuver": { "$ref": "#/components/schemas/AProuver" },
              "sansDomaine": { "$ref": "#/components/schemas/SansDomaine" }
            }
          }
        ]
      },
      "Urgence": {
        "type": "object",
        "additionalProperties": false,
        "required": ["niveau", "nombreAttendu"],
        "description": "Une faille, ou un logiciel : l'un ou l'autre.",
        "oneOf": [{ "required": ["faille"] }, { "required": ["logiciel"] }],
        "properties": {
          "faille": { "type": "string", "maxLength": 64 },
          "logiciel": { "type": "string", "maxLength": 100 },
          "niveau": { "type": "string", "enum": ["restreint", "maintenance"] },
          "nombreAttendu": { "type": "integer", "minimum": 1, "description": "Le nombre de sites que l'écran a montré : s'il a changé, la requête est refusée (`409`)." }
        }
      },
      "ResultatUrgence": {
        "type": "object",
        "required": ["ordres", "sondes"],
        "properties": { "ordres": { "type": "integer" }, "sondes": { "type": "array", "items": { "type": "string" } } }
      },
      "Domaine": {
        "type": "object",
        "required": ["id", "nom", "etat", "preuve", "sondes"],
        "properties": {
          "id": { "type": "string" },
          "nom": { "type": "string" },
          "etat": { "type": "string", "enum": ["a_prouver", "prouve", "perdu"] },
          "preuve": {
            "type": "object",
            "properties": {
              "txt": { "type": "object", "properties": { "nom": { "type": "string", "description": "« _manicou.exemple.fr »." }, "valeur": { "type": "string" } } },
              "fichier": { "type": "object", "properties": { "chemin": { "type": "string", "description": "« /.well-known/manicou.txt »." }, "contenu": { "type": "string" } } }
            }
          },
          "methode": { "type": ["string", "null"], "enum": ["dns", "fichier", null], "description": "Ce qui l'a prouvé : « Gardez l'enregistrement », ou le fichier. null avant la preuve." },
          "raison": { "type": ["string", "null"], "description": "Pourquoi la dernière vérification a échoué." },
          "lu": {
            "type": "object",
            "description": "« Nous lisons » d'A10, méthode par méthode, à côté de ce que `preuve` attend. Ce que le DNS ou le site renvoie, sur une ligne et borné : à afficher en texte.",
            "properties": {
              "txt": { "type": ["string", "null"], "description": "« aucun enregistrement TXT sur _manicou.exemple.org »." },
              "fichier": { "type": ["string", "null"], "description": "« https://exemple.org/.well-known/manicou.txt répond 404 »." }
            }
          },
          "prouveLe": { "$ref": "#/components/schemas/DateOuRien" },
          "verifieLe": { "$ref": "#/components/schemas/DateOuRien" },
          "sondes": { "type": "integer", "description": "Ses sites, à la minute ou non. Leurs noms : `GET /sondes?couvertesPar=exemple.org`." },
          "sondesMinute": { "type": "integer", "description": "Ses sites à la minute : protégés quand il est prouvé et que le compte a une formule." },
          "protection": {
            "type": "object",
            "description": "Sa protection (docs/PLAN.md §9) : un domaine ne se paie plus ; la formule du compte protège ses sites à la minute.",
            "required": ["active"],
            "properties": { "active": { "type": "boolean", "description": "Prouvé, une formule en cours, et au moins un site à la minute : « Active », sinon « Aucune »." } }
          }
        }
      },
      "ListeDomaines": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Domaine" } } } },
      "NouveauDomaine": {
        "type": "object",
        "additionalProperties": false,
        "required": ["nom"],
        "properties": { "nom": { "type": "string", "pattern": "^[a-z0-9.-]{1,253}$" } }
      },
      "Confirmation": {
        "type": "object",
        "additionalProperties": false,
        "required": ["confirmation"],
        "properties": { "confirmation": { "type": "string", "maxLength": 253, "description": "Le nom du domaine ou du compte, recopié." } }
      },
      "Protection": {
        "type": "object",
        "required": ["niveau", "depuis", "reglages", "recette", "ordres"],
        "properties": {
          "niveau": { "$ref": "#/components/schemas/Niveau" },
          "depuis": { "$ref": "#/components/schemas/DateOuRien", "description": "Le badge Restreint, « depuis 15:45 » : depuis quand le site applique ce niveau ; null au niveau normal." },
          "reglages": {
            "type": ["object", "null"],
            "description": "Ce que la recette recopie, pré-rempli : `/etc/manicou.json` pour nginx et Apache, `reglages.php` pour PHP, le garde des autres. Rien de secret. null sous un domaine non prouvé : le bloc verrouillé.",
            "required": ["sonde", "domaine", "adresse", "cles"],
            "properties": {
              "sonde": { "type": "string" },
              "domaine": { "type": "string", "description": "« extranet.exemple.fr » : celui que portent ses états signés (`EtatSigne.domaine`)." },
              "adresse": { "type": "string", "format": "uri", "description": "« https://app.manicou.dev/api/v1 »." },
              "cles": { "type": "object", "description": "Les clés publiques en service, par identifiant : { \"k1\": \"…\" }.", "additionalProperties": { "type": "string" } }
            }
          },
          "recette": {
            "type": "object",
            "required": ["type"],
            "properties": {
              "type": { "type": ["string", "null"], "enum": ["cloudflare", "node", "php", "nginx", "apache", "vercel", "netlify", null], "description": "« nginx », avec le badge Posée ; null : le badge Non posée, et « Poser la recette »." },
              "mode": { "type": ["string", "null"], "enum": ["webhook", "lecture", null] },
              "adresseWebhook": { "type": ["string", "null"] },
              "cheminEcriture": { "type": ["string", "null"], "description": "L'adresse que la recette bloque en `restreint`, pour constater l'effet de l'extérieur." },
              "derniereLectureLe": { "$ref": "#/components/schemas/DateOuRien", "description": "La dernière lecture de l'état signé, que quiconque garde l'identifiant de la sonde peut faire : une indication, jamais la preuve que la recette tient. A05 ne la montre pas." },
              "verifieeLe": { "$ref": "#/components/schemas/DateOuRien", "description": "Le dernier effet d'un ordre constaté de l'extérieur, essai compris : ce qu'A05 dit de la recette." }
            }
          },
          "ordres": { "type": "array", "items": { "$ref": "#/components/schemas/Ordre" }, "description": "Les 20 derniers." },
          "miseAJour": {
            "type": "object",
            "description": "La mise à jour du site par son workflow GitHub (D-106).",
            "required": ["workflowPose", "seule"],
            "properties": {
              "workflowPose": { "type": "boolean", "description": "Le workflow de mise à jour est posé dans le dépôt relié : elle part d'un clic, ou seule." },
              "seule": { "type": "boolean", "description": "La mise à jour seule est choisie (preciserMiseAJourSeule) : Manicou lance le workflow dès qu'une faille alertée, sûre ou probable, a une version corrigée." }
            }
          }
        }
      },
      "NouvelleProtection": {
        "type": "object",
        "additionalProperties": false,
        "required": ["type", "mode"],
        "properties": {
          "type": { "type": "string", "enum": ["cloudflare", "node", "php", "nginx", "apache", "vercel", "netlify"], "description": "L'hébergeur choisi à la première étape d'A12." },
          "mode": { "type": "string", "enum": ["webhook", "lecture"], "description": "L'un de ceux que `Recette.modes` donne pour ce type." },
          "adresseWebhook": { "type": "string", "format": "uri", "maxLength": 2048 },
          "cheminEcriture": { "type": "string", "maxLength": 200, "pattern": "^/[^/\\\\]", "description": "Un chemin du site : un seul / au début, et aucun \\." }
        }
      },
      "Levee": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "avantCorrectif": { "type": "boolean", "description": "Obligatoire, et vrai, tant qu'une faille reste ouverte sur ce site : la confirmation « La faille n'est pas corrigée. »" }
        }
      },
      "NomFormule": { "type": "string", "enum": ["solo", "pro", "agence", "plateforme"], "description": "Solo, 10 sites à la minute ; Pro, 50 ; Agence, 250 ; Plateforme, 1 000 (docs/PLAN.md §9)." },
      "DemandeFormule": { "type": "object", "additionalProperties": false, "required": ["formule"], "properties": { "formule": { "$ref": "#/components/schemas/NomFormule" }, "prixParMois": { "type": "number", "minimum": 0, "description": "Le prix par mois que l'écran montrait pour cette formule, celui d'`Abonnement.formules`. S'il a monté depuis, la dernière place du lancement étant partie, 409, et rien n'est demandé au marchand ni débité (D-126)." } } },
      "SortieFormule": {
        "type": "object",
        "required": ["adresse", "enAttente"],
        "properties": {
          "adresse": { "type": ["string", "null"], "format": "uri", "description": "Le paiement chez le marchand ; null pour un changement de formule." },
          "enAttente": { "type": "boolean", "description": "Un changement demandé, que l'événement signé du marchand appliquera." }
        }
      },
      "Ordre": {
        "type": "object",
        "required": ["id", "sonde", "niveau", "essai", "numero", "emisLe", "expireLe", "statut"],
        "properties": {
          "id": { "type": "string" },
          "sonde": { "type": "string" },
          "niveau": { "$ref": "#/components/schemas/Niveau" },
          "essai": { "type": "boolean" },
          "numero": { "type": "integer", "description": "Croissant pour chaque sonde : un état plus ancien que le dernier vu est ignoré." },
          "cle": { "type": "string", "description": "La clé qui l'a signé : son identifiant dans /.well-known/manicou/cles.json." },
          "emisLe": { "$ref": "#/components/schemas/Date" },
          "expireLe": { "$ref": "#/components/schemas/Date" },
          "accuseLe": { "$ref": "#/components/schemas/DateOuRien" },
          "effetConstateLe": { "$ref": "#/components/schemas/DateOuRien" },
          "retourLe": { "$ref": "#/components/schemas/DateOuRien", "description": "Un essai : le site revenu à la normale, constaté de l'extérieur. « Lu par le site » va de `emisLe` à `accuseLe`, « Effet constaté » de là à `effetConstateLe`, « Retour à la normale » de là à `retourLe`. Toujours null pour un ordre réel, qui revient par un autre ordre, `normal` (« Lever »)." },
          "statut": { "type": "string", "enum": ["emis", "accuse", "effet_constate", "retour_constate", "sans_accuse", "effet_absent", "sans_retour"], "description": "`retour_constate` : l'essai est fini, le badge Vérifié. `sans_retour` : le site d'un essai n'est pas revenu à la normale." }
        }
      },
      "EtatSigne": {
        "type": "object",
        "required": ["sonde", "domaine", "niveau", "numero", "emisLe", "expireLe", "cle", "essai"],
        "description": "Sans logiciel, version ni numéro de faille : rien que le site ne montrera déjà au public.",
        "properties": {
          "sonde": { "type": "string" },
          "domaine": { "type": "string" },
          "niveau": { "$ref": "#/components/schemas/Niveau" },
          "numero": { "type": "integer" },
          "emisLe": { "$ref": "#/components/schemas/Date" },
          "expireLe": { "$ref": "#/components/schemas/Date" },
          "cle": { "type": "string", "description": "L'identifiant de la clé qui a signé." },
          "essai": { "type": "boolean" },
          "echeance": {
            "oneOf": [{ "$ref": "#/components/schemas/Date" }, { "type": "null" }],
            "description": "Depuis la 0.12.141. Jusqu'à quand le garde tient cet état sans nouvelle de Manicou (D-111), six heures pour le restreint, quarante-huit pour la maintenance, un quart d'heure pour un essai, renouvelée à chaque lecture. null en normal. Une recette plus ancienne l'ignore."
          },
          "parti": {
            "type": "boolean",
            "description": "Depuis la 0.12.141, présent et vrai pour un site supprimé ou dont le compte est fermé. Manicou lui sert un an cet état normal, d'un numéro plus grand que tous ses ordres, et le garde dit au journal du site de retirer la recette."
          },
          "observation": {
            "type": "string",
            "enum": ["restreint", "maintenance"],
            "description": "Depuis la 0.12.180, présent sur un état normal quand l'interrupteur du garde est posé (D-145) : le niveau de l'ordre en cours, que le garde observe sans l'appliquer, en notant au journal du site ce qu'il aurait refusé. Une recette plus ancienne ne lit que « normal », et rouvre le site."
          }
        }
      },
      "Accuse": {
        "type": "object",
        "additionalProperties": false,
        "required": ["sonde", "numero", "niveau", "applique"],
        "properties": {
          "sonde": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" },
          "numero": { "type": "integer" },
          "niveau": { "$ref": "#/components/schemas/Niveau" },
          "applique": { "type": "boolean" },
          "detail": { "type": "string", "maxLength": 200 }
        }
      },
      "Fenetre": {
        "type": "object",
        "required": ["id", "debut", "dureeMinutes", "repetition", "fuseau"],
        "properties": {
          "id": { "type": "string" },
          "debut": { "$ref": "#/components/schemas/Date" },
          "dureeMinutes": { "type": "integer" },
          "repetition": { "type": "string", "enum": ["aucune", "jour", "semaine"] },
          "fuseau": { "type": ["string", "null"], "description": "Le fuseau IANA, sous son nom canonique." }
        }
      },
      "ListeFenetres": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Fenetre" } } } },
      "NouvelleFenetre": {
        "type": "object",
        "additionalProperties": false,
        "required": ["debut", "dureeMinutes"],
        "properties": {
          "debut": { "type": "string", "format": "date-time" },
          "dureeMinutes": { "type": "integer", "minimum": 5, "maximum": 10080 },
          "repetition": { "type": "string", "enum": ["aucune", "jour", "semaine"], "default": "aucune" },
          "fuseau": { "type": "string", "maxLength": 64, "description": "Fuseau IANA de l'heure locale (« America/Martinique », « Europe/Paris ») : une fenêtre répétée garde son heure locale, changement d'heure compris. Sans fuseau, elle revient toutes les 24 heures, ou tous les 7 jours, exactement." }
        }
      },
      "AdresseDeSortie": { "type": "object", "required": ["adresse"], "properties": { "adresse": { "type": "string", "format": "uri" } } },
      "AutorisationGithub": {
        "type": "object",
        "additionalProperties": false,
        "required": ["code", "etat"],
        "properties": {
          "code": { "type": "string", "maxLength": 100, "description": "Le paramètre `code` que GitHub renvoie après l'autorisation." },
          "etat": { "type": "string", "maxLength": 200, "description": "Le paramètre `state` de l'autorisation : celui que `terminerInstallationGithub` a donné à cette session." }
        }
      },
      "RetourGithub": {
        "type": "object",
        "additionalProperties": false,
        "required": ["installation", "etat"],
        "properties": {
          "installation": { "type": "integer" },
          "etat": { "type": "string", "maxLength": 200, "description": "Le paramètre `state` que GitHub renvoie : il doit être celui que la session a reçu." }
        }
      },
      "DepotsGithub": {
        "type": "object",
        "required": ["depots"],
        "properties": { "depots": { "type": "array", "items": { "type": "object", "properties": { "installation": { "type": "integer" }, "nom": { "type": "string" }, "prive": { "type": "boolean" } } } } }
      },
      "EvenementJournal": {
        "type": "object",
        "required": ["id", "le", "genre", "importance", "titre"],
        "properties": {
          "id": { "type": "string" },
          "le": { "$ref": "#/components/schemas/Date" },
          "genre": { "type": "string", "description": "en_ligne, panne, retour, ralentie, echeance, envoi, renvoi, sonde, fenetre, canal, cle, membre, compte, github ; puis faille, ordre, accuse, effet, levee, domaine, stack avec leurs pièces." },
          "importance": { "type": "string", "enum": ["info", "attention", "grave"] },
          "titre": { "type": "string" },
          "court": { "type": ["string", "null"], "description": "Le même en peu de mots, pour l'activité récente d'A02 : « En panne : code 502 ». Sans nom de faille sous un domaine non prouvé, comme `titre`. null : `titre`." },
          "sonde": { "type": ["string", "null"] },
          "sondeNom": { "type": ["string", "null"], "description": "Le nom du site : la colonne Site." },
          "sites": { "type": ["integer", "null"], "description": "« 3 sites » : un événement qui en vise plusieurs, `sonde` à null." },
          "faille": { "type": ["string", "null"] },
          "parNom": { "type": ["string", "null"], "description": "Qui a fait le geste : le nom d'un membre suivi de son adresse (« Marie · marie@exemple.fr »), ou son adresse seule. Le rôle lecture n'en lit que le domaine, puis le numéro du membre dans le compte, donné à son arrivée et jamais changé, le propriétaire ayant le 1 (« Marie · •••@exemple.fr · #2 »). null pour une clé, un ancien membre, ou Manicou." },
          "envoi": { "type": ["object", "null"], "description": "Pour une alerte envoyée : où en est son envoi. null si son canal a été supprimé.", "properties": { "essais": { "$ref": "#/components/schemas/EssaisDEnvoi" }, "cle": { "type": ["string", "null"], "description": "Pour un webhook : la clé qui a signé le dernier essai." }, "id": { "type": "string" }, "canal": { "type": ["string", "null"], "description": "null : l'adresse du propriétaire du compte, quand aucun canal ne recevait l'alerte (D-121)." }, "etat": { "type": "string", "enum": ["envoye", "en_attente", "echec"] }, "tentatives": { "type": "integer" }, "code": { "type": ["integer", "null"], "description": "Le code HTTP du dernier essai, sur un webhook ou une messagerie." }, "prochainEssaiLe": { "$ref": "#/components/schemas/DateOuRien" } } },
          "detail": { "type": "object", "description": "Les faits de l'événement, sans secret." }
        }
      },
      "PageEvenements": {
        "type": "object",
        "required": ["elements", "suivant"],
        "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/EvenementJournal" } }, "suivant": { "type": ["string", "null"] } }
      },
      "PageStatut": {
        "type": "object",
        "required": ["id", "nom", "titre", "sondes", "publique", "mention"],
        "properties": {
          "id": { "type": "string" },
          "nom": { "type": "string", "description": "Dans l'adresse de la page : status.manicou.dev/<nom>." },
          "titre": { "type": "string" },
          "sondes": { "type": "array", "items": { "type": "string" } },
          "publique": { "type": "boolean" },
          "mention": { "type": "boolean", "description": "« Surveillé par Manicou » : verrouillée dans l'offre gratuite." },
          "logo": { "type": ["string", "null"], "description": "L'adresse de son image (lireLogo), sur cette origine ; null sans logo." }
        }
      },
      "ListePages": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/PageStatut" } } } },
      "NouvellePage": {
        "type": "object",
        "additionalProperties": false,
        "required": ["nom", "titre"],
        "properties": {
          "nom": { "type": "string", "pattern": "^[a-z0-9-]{3,40}$" },
          "titre": { "type": "string", "maxLength": 100 },
          "sondes": { "type": "array", "maxItems": 100, "items": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" } },
          "publique": { "type": "boolean", "default": true }
        }
      },
      "ModifPage": {
        "type": "object",
        "additionalProperties": false,
        "minProperties": 1,
        "properties": {
          "titre": { "type": "string", "maxLength": 100 },
          "sondes": { "type": "array", "maxItems": 100, "items": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" } },
          "publique": { "type": "boolean" },
          "mention": { "type": "boolean", "description": "La retirer est payant." }
        }
      },
      "Reaction": {
        "type": "object",
        "additionalProperties": false,
        "required": ["canaux", "ordre"],
        "properties": {
          "canaux": { "type": "array", "maxItems": 20, "items": { "type": "string", "pattern": "^can_[0-9A-Za-z]{22}$" } },
          "ordre": { "type": "string", "enum": ["aucun", "restreint", "maintenance"], "description": "Aucun ordre par défaut." }
        }
      },
      "Politique": {
        "type": "object",
        "additionalProperties": false,
        "required": ["critique", "elevee", "moyenne", "faible", "aVerifier"],
        "properties": {
          "exploitee": { "$ref": "#/components/schemas/Reaction", "description": "Une faille exploitée, quelle que soit sa gravité. Absente à l'écriture : comme `critique`. Toujours présente à la lecture." },
          "critique": { "$ref": "#/components/schemas/Reaction" },
          "elevee": { "$ref": "#/components/schemas/Reaction" },
          "moyenne": { "$ref": "#/components/schemas/Reaction" },
          "faible": { "$ref": "#/components/schemas/Reaction" },
          "aVerifier": {
            "type": "object",
            "additionalProperties": false,
            "required": ["canaux"],
            "properties": { "canaux": { "type": "array", "maxItems": 20, "items": { "type": "string", "pattern": "^can_[0-9A-Za-z]{22}$" } } }
          }
        }
      },
      "PolitiqueDeSonde": {
        "type": "object",
        "additionalProperties": false,
        "required": ["sonde", "politique"],
        "properties": { "sonde": { "type": "string", "pattern": "^snd_[0-9A-Za-z]{22}$" }, "politique": { "$ref": "#/components/schemas/Politique" } }
      },
      "Politiques": {
        "type": "object",
        "required": ["compte", "sondes", "rythmes"],
        "properties": { "compte": { "$ref": "#/components/schemas/Politique" }, "sondes": { "type": "array", "items": { "$ref": "#/components/schemas/PolitiqueDeSonde" } }, "rythmes": { "$ref": "#/components/schemas/Rythmes" } }
      },
      "Rythmes": {
        "type": "object",
        "additionalProperties": false,
        "description": "Les pannes, le rappel d'une faille ouverte et le résumé de la semaine, pour tout le compte.",
        "required": ["pannes", "rappel", "resume"],
        "properties": {
          "pannes": { "type": "array", "maxItems": 20, "description": "Les canaux des pannes et des retours. Sans réglage : tous ceux du compte.", "items": { "type": "string", "pattern": "^can_[0-9A-Za-z]{22}$" } },
          "rappel": { "type": "string", "enum": ["jour", "semaine", "jamais"], "description": "Une faille exploitée encore ouverte : chaque jour à 8:00, le lundi à 8:00, ou jamais, à l'heure du compte." },
          "resume": { "type": "string", "enum": ["lundi", "jamais"], "description": "Le résumé de la semaine (M11) : le lundi à 8:00, à l'heure du compte, ou jamais." }
        }
      },
      "EssaisDEnvoi": {
        "type": "array",
        "description": "Le reçu de chaque essai, du premier au dernier : son heure, son code HTTP (rien pour un e-mail), le temps de la réponse, son issue et sa raison, la référence que le service lui a donnée, l'attente qu'il a demandée. Jamais une adresse ni un jeton. Un essai d'avant la 0.12.148 n'a que son heure et son code.",
        "items": {
          "type": "object",
          "required": ["le", "code"],
          "properties": {
            "le": { "$ref": "#/components/schemas/Date" },
            "code": { "type": ["integer", "null"] },
            "delaiMs": { "type": "integer", "description": "Le temps de la réponse, en millisecondes." },
            "issue": { "type": "string", "enum": ["livre", "passager", "refuse", "casse"], "description": "livre, reçu ; passager, il se réessaie ; refuse, l'envoi s'arrête ; casse, le service dit le canal mort ou fermé." },
            "raison": { "type": "string", "enum": ["introuvable", "archive", "refuse", "parti", "refus_repetes", "reseau", "delai", "redirection", "serveur", "trop_de_requetes", "forme", "inattendu", "courriel", "cle", "adresse", "hors_compte", "canal_casse", "adresse_a_verifier"], "description": "`cle` : la clé de signature manque, ou le secret d'un webhook ne se déchiffre plus. `adresse_a_verifier` : un webhook dont l'adresse n'est pas vérifiée, rien n'est parti, et le canal ne compte aucun refus (C11)." },
            "reference": { "type": "string", "description": "L'identifiant que le service a donné : celui d'un e-mail, ou d'un message de Discord." },
            "attenteMs": { "type": "integer", "description": "L'attente que le service a demandée (Retry-After, ou retry_after de Discord)." }
          }
        }
      },
      "SessionVue": {
        "type": "object",
        "required": ["id", "navigateur", "systeme", "vueLe", "courante"],
        "properties": {
          "id": { "type": "string" },
          "navigateur": { "type": ["string", "null"], "description": "Lu une fois à la connexion : « Chrome ». Ni l'en-tête entier, ni l'adresse IP ne se gardent." },
          "systeme": { "type": ["string", "null"], "description": "« Windows »." },
          "vueLe": { "$ref": "#/components/schemas/Date" },
          "courante": { "type": "boolean" }
        }
      },
      "ListeSessions": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/SessionVue" } } } },
      "ListeExports": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Export" } } } },
      "NouvellesPolitiques": {
        "type": "object",
        "additionalProperties": false,
        "required": ["compte", "sondes"],
        "properties": {
          "compte": { "$ref": "#/components/schemas/Politique" },
          "sondes": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/components/schemas/PolitiqueDeSonde" } },
          "rythmes": { "$ref": "#/components/schemas/Rythmes" },
          "ordresConfirmes": { "type": "boolean", "description": "Obligatoire, et vrai, quand la requête active un ordre qui ne l'était pas (fenêtre O05)." }
        }
      },
      "Canal": {
        "type": "object",
        "required": ["id", "type", "nom", "cible", "creeLe"],
        "properties": {
          "id": { "type": "string" },
          "type": { "type": "string", "enum": ["email", "webhook", "slack", "discord", "teams"] },
          "nom": { "type": "string" },
          "cible": { "type": "string", "description": "L'adresse e-mail, ou l'adresse du webhook masquée sauf ses quatre derniers caractères." },
          "verifieLe": { "$ref": "#/components/schemas/DateOuRien", "description": "La dernière preuve que le canal reçoit : l'adresse d'un membre, prouvée par sa connexion, la vérification de l'adresse d'un webhook, ou le dernier envoi réussi." },
          "secretCreeLe": { "$ref": "#/components/schemas/DateOuRien", "description": "Un webhook : quand son secret a été tiré, à sa création ou à son renouvellement (verifierCanal, renouvelerSecret). null pour un webhook d'avant la 0.12.175, qui n'en a pas, et pour les autres canaux." },
          "adresseVerifieeLe": { "$ref": "#/components/schemas/DateOuRien", "description": "Un webhook : quand son adresse s'est vérifiée avec son secret, par le défi de Standard Webhooks (le webhook `verification`). null : il ne reçoit rien, essai compris. Toujours null pour les autres canaux." },
          "secret": { "type": "string", "description": "Le secret d'un webhook, « whsec_ » puis 32 octets en base64, dans la réponse de sa création ou de son renouvellement, cette seule fois. Il signe ses alertes en v1 et sert à répondre au défi de la vérification." },
          "creeLe": { "$ref": "#/components/schemas/Date" },
          "dernierSuccesLe": { "$ref": "#/components/schemas/DateOuRien", "description": "Le dernier envoi réussi, essai compris ; null si aucun." },
          "casse": {
            "type": ["object", "null"],
            "description": "Cassé : son service le dit mort ou fermé (un 404, un 401 ou un 403 de Slack, Discord ou Teams, un code de Slack qui le dit, un 410), ou un webhook générique a refusé trois alertes de suite. Il ne reçoit plus que les essais, et un essai réussi le répare. Le propriétaire du compte a reçu M18.",
            "required": ["le", "raison"],
            "properties": { "le": { "$ref": "#/components/schemas/Date" }, "raison": { "type": "string", "enum": ["introuvable", "archive", "refuse", "parti", "refus_repetes"] } }
          },
          "dernierEnvoi": {
            "type": ["object", "null"],
            "description": "Le dernier message parti sur ce canal, essai compris : ce que l'écran montre après « Envoyer un essai ».",
            "required": ["id", "genre", "etat", "tentatives", "code", "creeLe", "envoyeLe"],
            "properties": {
              "id": { "type": "string" },
              "genre": { "type": "string", "description": "panne, retour, bienvenue, semaine, essai…" },
              "etat": { "type": "string", "enum": ["envoye", "en_attente", "echec"] },
              "tentatives": { "type": "integer" },
              "code": { "type": ["integer", "null"], "description": "Le code HTTP de la dernière tentative ; rien pour un e-mail." },
              "creeLe": { "$ref": "#/components/schemas/Date" },
              "envoyeLe": { "$ref": "#/components/schemas/DateOuRien" },
              "prochainEssaiLe": { "$ref": "#/components/schemas/DateOuRien" },
              "essais": { "$ref": "#/components/schemas/EssaisDEnvoi" },
              "cle": { "type": ["string", "null"], "description": "Pour un webhook d'avant la 0.12.175 : la clé de Manicou qui a signé le dernier essai. null depuis, chaque webhook signant avec son propre secret." }
            }
          }
        }
      },
      "ListeCanaux": { "type": "object", "required": ["elements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/Canal" } } } },
      "NouveauCanal": {
        "type": "object",
        "additionalProperties": false,
        "required": ["type", "nom", "cible"],
        "properties": {
          "type": { "type": "string", "enum": ["email", "webhook", "slack", "discord", "teams"] },
          "nom": { "type": "string", "maxLength": 100 },
          "cible": { "type": "string", "maxLength": 2048, "description": "L'adresse e-mail d'un membre du compte, ou l'adresse https du webhook : Slack, https://hooks.slack.com/services/… ; Discord, https://discord.com/api/webhooks/… ; Teams, celle d'un webhook de Workflows (….environment.api.powerplatform.com) ; un webhook générique, une adresse https publique, qui reçoit AlerteWebhook signée en v1 avec le secret de son canal, montré dans la réponse, une fois son adresse vérifiée." }
        }
      },
      "Membre": {
        "type": "object",
        "required": ["id", "email", "role"],
        "properties": {
          "id": { "type": "string" },
          "email": { "type": "string", "format": "email" },
          "nom": { "type": ["string", "null"], "description": "Celui qu'il a donné ; null : montrer son adresse." },
          "role": { "type": "string", "enum": ["proprietaire", "gestion", "lecture"] },
          "derniereVisiteLe": { "$ref": "#/components/schemas/DateOuRien" }
        }
      },
      "Invitation": {
        "type": "object",
        "required": ["id", "email", "role", "expireLe"],
        "properties": {
          "id": { "type": "string" },
          "email": { "type": "string", "format": "email" },
          "role": { "type": "string", "enum": ["gestion", "lecture"] },
          "expireLe": { "$ref": "#/components/schemas/Date" },
          "par": { "type": ["string", "null"], "format": "email", "description": "L'adresse du membre qui l'a envoyée, dans la liste de l'équipe ; null pour une invitation d'avant la 0.12.153. Elle expire quand il quitte le compte ou passe en lecture, et ne s'accepte que s'il garde le rôle gestion ou propriétaire." }
        }
      },
      "Equipe": {
        "type": "object",
        "required": ["membres", "invitations", "battements"],
        "properties": {
          "membres": { "type": "array", "items": { "$ref": "#/components/schemas/Membre" } },
          "invitations": { "type": "array", "items": { "$ref": "#/components/schemas/Invitation" } },
          "battements": { "type": "integer", "minimum": 0, "description": "Le nombre de battements du compte : au départ d'un membre qui a pu lire leur adresse, A18 propose de la renouveler (renouvelerJeton)." }
        }
      },
      "NouvelleInvitation": {
        "type": "object",
        "additionalProperties": false,
        "required": ["email", "role"],
        "properties": { "email": { "type": "string", "format": "email", "maxLength": 254 }, "role": { "type": "string", "enum": ["gestion", "lecture"] } }
      },
      "ModifMembre": {
        "type": "object",
        "additionalProperties": false,
        "required": ["role"],
        "properties": { "role": { "type": "string", "enum": ["gestion", "lecture"] } }
      },
      "CleApi": {
        "type": "object",
        "required": ["id", "nom", "droits", "debut", "creeLe"],
        "properties": {
          "id": { "type": "string" },
          "nom": { "type": "string" },
          "droits": { "type": "string", "enum": ["lecture", "ecriture"] },
          "ordres": { "type": "boolean", "description": "La clé donne des ordres : mettre à l'abri, lever, essayer, poser les politiques, lancer une mise à jour. Sans lui, ces routes répondent 403 `cle_sans_ordres`." },
          "sonde": { "type": ["string", "null"], "pattern": "^snd_[0-9A-Za-z]{22}$", "description": "Le site auquel la clé est limitée : elle n'y fait que déposer un fichier, `PUT /sondes/{sonde}/stack`, et toute autre route lui répond 403 `cle_limitee`. Supprimer le site la révoque. null : tout le compte." },
          "sondeNom": { "type": ["string", "null"], "description": "Le nom de ce site : « Limitée à blog.exemple.fr » (A19). null avec `sonde` à null." },
          "debut": { "type": "string", "description": "Les premiers caractères de la clé, pour la reconnaître." },
          "creeLe": { "$ref": "#/components/schemas/Date" },
          "dernierUsageLe": { "$ref": "#/components/schemas/DateOuRien" }
        }
      },
      "ListeCles": { "type": "object", "required": ["elements", "battements"], "properties": { "elements": { "type": "array", "items": { "$ref": "#/components/schemas/CleApi" } }, "battements": { "type": "integer", "description": "Les tâches planifiées du compte. Une clé en écriture qui n'est pas limitée à un site lit l'adresse de leur battement : A19 propose de la renouveler quand on la révoque (A16)." } } },
      "NouvelleCle": {
        "type": "object",
        "additionalProperties": false,
        "required": ["nom", "droits"],
        "properties": {
          "nom": { "type": "string", "maxLength": 100 },
          "droits": { "type": "string", "enum": ["lecture", "ecriture"] },
          "ordres": { "type": "boolean", "default": false, "description": "Seulement avec les droits ecriture." },
          "sonde": { "type": ["string", "null"], "pattern": "^snd_[0-9A-Za-z]{22}$", "description": "Limiter la clé à ce site du compte, pour une CI (O02) : avec les droits ecriture, sans ordres. Un site d'un autre compte ou inconnu : 422 sur `sonde`. Absent ou null : tout le compte." }
        }
      },
      "CleCreee": {
        "allOf": [
          { "$ref": "#/components/schemas/CleApi" },
          { "type": "object", "required": ["cle"], "properties": { "cle": { "type": "string", "description": "Montrée cette seule fois : la base n'en garde que l'empreinte." } } }
        ]
      },
      "Abonnement": {
        "type": "object",
        "required": ["etat", "formule", "lancement", "prixParMois", "periode", "renouvellementLe", "sitesMinute", "sitesGratuits", "formules"],
        "properties": {
          "etat": { "type": "string", "enum": ["gratuit", "actif", "impaye", "annule"] },
          "formule": { "oneOf": [{ "$ref": "#/components/schemas/NomFormule" }, { "type": "null" }], "description": "La formule en cours, payée ou en relance de paiement ; null sans formule." },
          "lancement": { "type": "boolean", "description": "Avec une formule, elle est payée au tiers du prix, prise pendant le lancement, et le reste à vie tant que le compte la garde. Sans formule, il reste des places, et toute formule se paierait au tiers du prix." },
          "prixParMois": { "type": ["integer", "null"], "description": "En centimes d'euro : le prix garanti de la formule en cours ; null sans formule." },
          "periode": { "type": ["string", "null"], "enum": ["annee", "mois", null] },
          "renouvellementLe": { "$ref": "#/components/schemas/DateOuRien" },
          "sitesMinute": { "$ref": "#/components/schemas/Compteur", "description": "Ses sites à la minute, et ce que sa formule en compte : 0 sans formule." },
          "sitesGratuits": { "$ref": "#/components/schemas/Compteur", "description": "Ses sites à 5 minutes, battements compris : 50 pour tout compte." },
          "formules": {
            "type": "array",
            "description": "Chaque formule, au prix qu'elle aurait pour ce compte, payée à l'année.",
            "items": {
              "type": "object",
              "required": ["id", "sites", "prixParMois", "prixParAn", "prixPleinParMois"],
              "properties": {
                "id": { "$ref": "#/components/schemas/NomFormule" },
                "sites": { "type": "integer", "description": "Ses sites à la minute." },
                "prixParMois": { "type": "integer", "description": "En centimes d'euro, ce que ce compte paierait. Le tiers du prix tant qu'il reste des places, et sur la formule qu'un client du lancement garde, sinon le plein tarif." },
                "prixParAn": { "type": "integer", "description": "En centimes d'euro." },
                "prixPleinParMois": { "type": "integer", "description": "En centimes d'euro : le prix plein, que l'écran barre quand celui du compte est plus bas (A20)." }
              }
            }
          }
        }
      },
      "Compteur": { "type": "object", "required": ["utilises", "max"], "properties": { "utilises": { "type": "integer" }, "max": { "type": "integer" } } },
      "Compte": {
        "type": "object",
        "required": ["id", "nom", "offre", "langue", "fuseau", "creeLe"],
        "properties": {
          "id": { "type": "string" },
          "nom": { "type": "string" },
          "offre": { "type": "string", "enum": ["gratuite", "domaines"] },
          "langue": { "type": "string", "enum": ["fr", "en"], "description": "La langue des écrans et des e-mails : celle du navigateur à l'inscription, puis celle choisie dans A21." },
          "fuseau": { "type": ["string", "null"], "description": "Le fuseau IANA des heures des e-mails ; sans lui, l'heure UTC. Celui du navigateur à l'inscription, puis celui choisi dans A21." },
          "creeLe": { "$ref": "#/components/schemas/Date" },
          "suppressionLe": { "$ref": "#/components/schemas/DateOuRien" }
        }
      },
      "ModifCompte": {
        "type": "object",
        "additionalProperties": false,
        "minProperties": 1,
        "properties": {
          "nom": { "type": "string", "maxLength": 100 },
          "langue": { "type": "string", "enum": ["fr", "en"] },
          "fuseau": { "type": ["string", "null"], "maxLength": 64 }
        }
      },
      "Export": {
        "type": "object",
        "required": ["id", "etat", "creeLe"],
        "properties": {
          "id": { "type": "string" },
          "etat": { "type": "string", "enum": ["en_cours", "pret", "expire", "echec"], "description": "echec, l'archive n'a pas pu être préparée, trop lourde pour un appel (huit cents requêtes ou 2 Gio) ou abandonnée après deux jours, et M19 en dit la raison à qui l'a demandée. Un export passe aussi en échec quand son auteur part ou passe en lecture (D-124, D-132)." },
          "adresse": { "type": ["string", "null"], "description": "L'adresse de l'archive, avec la session ; l'e-mail M15 en donne une qui s'ouvre sans elle. Valable 7 jours, ou jusqu'à la suppression du compte fermé." },
          "creeLe": { "$ref": "#/components/schemas/Date" },
          "expireLe": { "$ref": "#/components/schemas/DateOuRien" }
        }
      },
      "ClesPubliques": {
        "type": "object",
        "required": ["cles"],
        "properties": {
          "cles": {
            "type": "array",
            "items": {
              "type": "object",
              "required": ["id", "alg", "cle"],
              "properties": {
                "id": { "type": "string" },
                "alg": { "type": "string", "enum": ["Ed25519"] },
                "cle": { "type": "string", "description": "La clé publique brute, en base64." },
                "jusqua": { "$ref": "#/components/schemas/DateOuRien" }
              }
            }
          }
        }
      },
      "AlerteWebhook": {
        "type": "object",
        "required": ["id", "genre", "le", "titre", "lien"],
        "properties": {
          "id": { "type": "string", "description": "L'identifiant stable de l'alerte, celui de l'en-tête webhook-id." },
          "genre": { "type": "string", "enum": ["panne", "retour", "echeance", "faille", "a_verifier", "ordre_sans_effet", "corrigee", "rappel", "stack_ancienne", "preuve_perdue", "essai", "protection"], "description": "`protection`, M20 (D-134), la maintenance d'un site repasse en restreint dans huit heures, ou vient d'y repasser, avec le lien qui la relance, ou sa protection reste en place après une liste déposée sans le droit des ordres, avec le lien qui la lève." },
          "le": { "$ref": "#/components/schemas/Date" },
          "titre": { "type": "string" },
          "sonde": { "type": ["string", "null"] },
          "faille": { "type": ["string", "null"] },
          "severite": { "type": ["string", "null"], "description": "La gravité de la faille, son impact seul, « critique », « elevee », « moyenne » ou « faible » (D-128). Qu'elle soit exploitée se lit dans `exploitee`." },
          "exploitee": { "type": ["boolean", "null"], "description": "La faille est exploitée en ce moment, d'après la liste de la CISA, son point SSVC ou sa source (D-128, D-148). `null` pour une alerte qui ne parle d'aucune faille. À lire avant `severite` pour trier, comme le fait Manicou." },
          "lien": { "type": "string", "format": "uri", "description": "L'écran de l'espace client qui en dit plus." }
        }
      }
    }
  }
}
