{
    "openapi": "3.1.0",
    "info": {
        "title": "API Heyalink pour les entreprises (ancienne adresse commune)",
        "version": "1.13.0",
        "summary": "Offres d’emploi et formations, publiées et tenues à jour depuis votre site.",
        "description": "Offres d’emploi et formations, publiées et tenues à jour depuis votre site. Heyalink, le réseau professionnel de la construction.\n\nL’API Emploi est comprise dans la formule Grands comptes de la page ; l’API Formation, dans Pro Formation et Grands comptes. Une clé appartient à une page et à cette API seule.\n\nContrat stable : l’API v1 n’évolue que de façon compatible ; une rupture passerait en v2.\n\nPowered by ● Oriq IA.",
        "contact": {
            "name": "Heyalink",
            "url": "https://www.heyalink.com",
            "email": "info-contact@heyalink.com"
        },
        "x-api-designer": {
            "name": "Oriq IA",
            "url": "https://oriq.fr"
        }
    },
    "servers": [
        {
            "url": "https://www.heyalink.com/api/entreprises/v1"
        }
    ],
    "tags": [
        {
            "name": "Offres d’emploi"
        },
        {
            "name": "Sous-traitance"
        },
        {
            "name": "Formations"
        },
        {
            "name": "Services"
        },
        {
            "name": "Compte"
        },
        {
            "name": "Sources"
        }
    ],
    "paths": {
        "/offres": {
            "get": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offresLister",
                "summary": "Lister vos offres d’emploi",
                "security": [
                    {
                        "bearer": [
                            "offres:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:lecture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "limite",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 100
                        }
                    },
                    {
                        "name": "curseur",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Le curseur `suivant` de la page précédente."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "offres",
                                        "suivant",
                                        "limite"
                                    ],
                                    "properties": {
                                        "offres": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/OffrePubliee"
                                            }
                                        },
                                        "suivant": {
                                            "type": [
                                                "string",
                                                "null"
                                            ]
                                        },
                                        "limite": {
                                            "type": "integer"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Rien n’a changé (If-None-Match)."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "get": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offreLire",
                "summary": "Lire une annonce et son état",
                "security": [
                    {
                        "bearer": [
                            "offres:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:lecture"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "offre"
                                    ],
                                    "properties": {
                                        "offre": {
                                            "$ref": "#/components/schemas/OffrePubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Rien n’a changé (If-None-Match)."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offrePublier",
                "summary": "Publier ou modifier (idempotent)",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "description": "Depuis la v1.11.0 : une annonce supprimée sur Heyalink par un gérant de la page ne revient jamais. La même référence renvoyée répond 409, `code` `annonce_supprimee`, `supprimee_le` ; pour la republier, utilisez une nouvelle référence. Une annonce fermée par un gérant se met à jour mais reste fermée : seul un gérant la rouvre (ou `…/rouvrir`).",
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/Offre"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Modifiée, inchangée ou doublon.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "offre",
                                        "resultat",
                                        "avertissements"
                                    ],
                                    "properties": {
                                        "offre": {
                                            "$ref": "#/components/schemas/OffrePubliee"
                                        },
                                        "resultat": {
                                            "type": "string",
                                            "enum": [
                                                "creee",
                                                "modifiee",
                                                "restauree",
                                                "inchangee",
                                                "doublon"
                                            ]
                                        },
                                        "avertissements": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "signalements": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Signalement"
                                            },
                                            "description": "Ce que Heyalink a remarqué sur l’annonce reçue, sans la refuser : champs ignorés, champs recommandés absents (l’annonce sortira du filtre correspondant), valeurs déduites par l’algorithme de Heyalink, incohérences. Rendu depuis la v1.6.0."
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Créée, ou revenue en ligne.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "offre",
                                        "resultat",
                                        "avertissements"
                                    ],
                                    "properties": {
                                        "offre": {
                                            "$ref": "#/components/schemas/OffrePubliee"
                                        },
                                        "resultat": {
                                            "type": "string",
                                            "enum": [
                                                "creee",
                                                "modifiee",
                                                "restauree",
                                                "inchangee",
                                                "doublon"
                                            ]
                                        },
                                        "avertissements": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "signalements": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Signalement"
                                            },
                                            "description": "Ce que Heyalink a remarqué sur l’annonce reçue, sans la refuser : champs ignorés, champs recommandés absents (l’annonce sortira du filtre correspondant), valeurs déduites par l’algorithme de Heyalink, incohérences. Rendu depuis la v1.6.0."
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offreSupprimer",
                "summary": "Supprimer (un PUT la ramène)",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Supprimée, ou déjà absente."
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}/archivage": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offreArchiver",
                "summary": "Archiver",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "offre"
                                    ],
                                    "properties": {
                                        "offre": {
                                            "$ref": "#/components/schemas/OffrePubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}/pourvue": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offrePourvue",
                "summary": "Marquer pourvue",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "offre"
                                    ],
                                    "properties": {
                                        "offre": {
                                            "$ref": "#/components/schemas/OffrePubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}/fermer": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offreFermer",
                "summary": "Fermer (l’annonce ne reçoit plus de réponses)",
                "description": "Depuis la v1.11.0 (07/11/2026). L’annonce sort des listes et de la limite de votre formule ; elle reste lisible par ceux qui ont répondu, qui sont prévenus. État `fermee`, webhook `annonce.fermee`. Elle se rouvre par `…/rouvrir`.",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "offre"
                                    ],
                                    "properties": {
                                        "offre": {
                                            "$ref": "#/components/schemas/OffrePubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}/rouvrir": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offreRouvrir",
                "summary": "Rouvrir une annonce fermée",
                "description": "Depuis la v1.11.0. De nouveau en ligne, dans la limite de votre formule : 403 quand elle est atteinte. Webhook `annonce.rouverte`.",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "offre"
                                    ],
                                    "properties": {
                                        "offre": {
                                            "$ref": "#/components/schemas/OffrePubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}/apercu": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "get": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offreApercu",
                "summary": "La fiche telle qu’un membre la voit",
                "description": "Depuis la v1.11.0. `fiche` est l’objet que l’application Heyalink affiche, calculé pour un membre quelconque. Une annonce du bac à sable n’a pas de fiche (404).",
                "security": [
                    {
                        "bearer": [
                            "offres:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:lecture"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "reference",
                                        "etat",
                                        "reponses",
                                        "fiche"
                                    ],
                                    "properties": {
                                        "reference": {
                                            "type": "string"
                                        },
                                        "etat": {
                                            "type": "string"
                                        },
                                        "reponses": {
                                            "type": "integer",
                                            "description": "Le nombre de personnes qui ont répondu."
                                        },
                                        "fiche": {
                                            "type": "object"
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}/pieces": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offrePiecesAjouter",
                "summary": "Joindre des photos et des PDF",
                "description": "Depuis la v1.12.0. `photos` : 6 au plus au total (JPEG, PNG, WebP, HEIC, 10 Mo chacune), la première est le visuel de l’annonce et de son partage ; `documents` : 6 PDF au plus au total (20 Mo chacun). Chaque fichier est `{nom, donnees}` (base64, avec ou sans `data:…;base64,`). Chaque pièce est lue par la modération avant d’être montrée aux membres (`statut` `verification`) ; refusée, elle déclenche le webhook `annonce.piece_refusee`. Une annonce importée n’en porte pas (403). Le bac à sable n’en garde pas.",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "photos": {
                                        "type": "array",
                                        "maxItems": 6,
                                        "items": {
                                            "type": "object",
                                            "required": [
                                                "donnees"
                                            ],
                                            "properties": {
                                                "nom": {
                                                    "type": "string"
                                                },
                                                "donnees": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "documents": {
                                        "type": "array",
                                        "maxItems": 6,
                                        "items": {
                                            "type": "object",
                                            "required": [
                                                "donnees"
                                            ],
                                            "properties": {
                                                "nom": {
                                                    "type": "string"
                                                },
                                                "donnees": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Les pièces de l’annonce, dans l’ordre.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "media"
                                    ],
                                    "properties": {
                                        "media": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PieceDAnnonce"
                                            }
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}/pieces/ordre": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "put": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offrePiecesRanger",
                "summary": "Ranger les photos",
                "description": "Depuis la v1.12.0. `ordre` : les identifiants des photos dans l’ordre voulu ; celles qui manquent suivent, dans leur ordre d’avant. La première devient le visuel.",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "ordre"
                                ],
                                "properties": {
                                    "ordre": {
                                        "type": "array",
                                        "items": {
                                            "type": "integer"
                                        }
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "media"
                                    ],
                                    "properties": {
                                        "media": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PieceDAnnonce"
                                            }
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/{reference}/pieces/{piece}": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CC-2026-014"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                },
                {
                    "name": "piece",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    }
                }
            ],
            "delete": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offrePiecesRetirer",
                "summary": "Retirer une photo ou un PDF",
                "description": "Depuis la v1.12.0. Le fichier est effacé.",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Retirée."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/lot": {
            "post": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offresLot",
                "summary": "Envoyer jusqu’à 100 annonces et retraits",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "offres": {
                                        "type": "array",
                                        "maxItems": 100,
                                        "items": {
                                            "$ref": "#/components/schemas/Offre"
                                        }
                                    },
                                    "retirer": {
                                        "type": "array",
                                        "maxItems": 100,
                                        "items": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "bilan",
                                        "resultats",
                                        "retraits"
                                    ],
                                    "properties": {
                                        "bilan": {
                                            "type": "object",
                                            "required": [
                                                "creees",
                                                "modifiees",
                                                "inchangees",
                                                "doublons",
                                                "retirees",
                                                "refusees"
                                            ],
                                            "properties": {
                                                "creees": {
                                                    "type": "integer"
                                                },
                                                "modifiees": {
                                                    "type": "integer"
                                                },
                                                "inchangees": {
                                                    "type": "integer"
                                                },
                                                "doublons": {
                                                    "type": "integer"
                                                },
                                                "retirees": {
                                                    "type": "integer"
                                                },
                                                "refusees": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "resultats": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "required": [
                                                    "index",
                                                    "statut"
                                                ],
                                                "properties": {
                                                    "index": {
                                                        "type": "integer"
                                                    },
                                                    "reference": {
                                                        "type": [
                                                            "string",
                                                            "null"
                                                        ]
                                                    },
                                                    "statut": {
                                                        "type": "integer",
                                                        "enum": [
                                                            200,
                                                            201,
                                                            409,
                                                            422
                                                        ]
                                                    },
                                                    "code": {
                                                        "type": "string",
                                                        "description": "`annonce_supprimee` (409) : supprimée sur Heyalink par un gérant, la référence ne la ramène pas."
                                                    },
                                                    "resultat": {
                                                        "type": "string"
                                                    },
                                                    "offre": {
                                                        "$ref": "#/components/schemas/OffrePubliee"
                                                    },
                                                    "avertissements": {
                                                        "type": "array",
                                                        "items": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "signalements": {
                                                        "type": "array",
                                                        "items": {
                                                            "$ref": "#/components/schemas/Signalement"
                                                        },
                                                        "description": "Ce que Heyalink a remarqué sur l’annonce reçue, sans la refuser : champs ignorés, champs recommandés absents (l’annonce sortira du filtre correspondant), valeurs déduites par l’algorithme de Heyalink, incohérences. Rendu depuis la v1.6.0."
                                                    },
                                                    "message": {
                                                        "type": "string"
                                                    },
                                                    "errors": {
                                                        "type": "object"
                                                    },
                                                    "violations": {
                                                        "type": "array",
                                                        "items": {
                                                            "$ref": "#/components/schemas/Violation"
                                                        }
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "retraits": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "required": [
                                                    "reference",
                                                    "retiree"
                                                ],
                                                "properties": {
                                                    "reference": {
                                                        "type": "string"
                                                    },
                                                    "retiree": {
                                                        "type": "boolean"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/offres/synchronisation": {
            "post": {
                "tags": [
                    "Offres d’emploi"
                ],
                "operationId": "offresSynchronisation",
                "summary": "Synchronisation complète : ce qui manque est archivé",
                "security": [
                    {
                        "bearer": [
                            "offres:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "offres:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "references"
                                ],
                                "properties": {
                                    "references": {
                                        "type": "array",
                                        "maxItems": 5000,
                                        "items": {
                                            "type": "string"
                                        }
                                    },
                                    "confirmer_liste_vide": {
                                        "type": "boolean"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "bilan"
                                    ],
                                    "properties": {
                                        "bilan": {
                                            "type": "object",
                                            "required": [
                                                "references_recues",
                                                "archivees"
                                            ],
                                            "properties": {
                                                "references_recues": {
                                                    "type": "integer"
                                                },
                                                "archivees": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations": {
            "get": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationsLister",
                "summary": "Lister vos formations",
                "security": [
                    {
                        "bearer": [
                            "formations:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:lecture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "limite",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 100
                        }
                    },
                    {
                        "name": "curseur",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Le curseur `suivant` de la page précédente."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "formations",
                                        "suivant",
                                        "limite"
                                    ],
                                    "properties": {
                                        "formations": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/FormationPubliee"
                                            }
                                        },
                                        "suivant": {
                                            "type": [
                                                "string",
                                                "null"
                                            ]
                                        },
                                        "limite": {
                                            "type": "integer"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Rien n’a changé (If-None-Match)."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "get": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationLire",
                "summary": "Lire une annonce et son état",
                "security": [
                    {
                        "bearer": [
                            "formations:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:lecture"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "formation"
                                    ],
                                    "properties": {
                                        "formation": {
                                            "$ref": "#/components/schemas/FormationPubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Rien n’a changé (If-None-Match)."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationPublier",
                "summary": "Publier ou modifier (idempotent)",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "description": "Depuis la v1.11.0 : une annonce supprimée sur Heyalink par un gérant de la page ne revient jamais. La même référence renvoyée répond 409, `code` `annonce_supprimee`, `supprimee_le` ; pour la republier, utilisez une nouvelle référence. Une annonce fermée par un gérant se met à jour mais reste fermée : seul un gérant la rouvre (ou `…/rouvrir`).",
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/Formation"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Modifiée, inchangée ou doublon.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "formation",
                                        "resultat",
                                        "avertissements"
                                    ],
                                    "properties": {
                                        "formation": {
                                            "$ref": "#/components/schemas/FormationPubliee"
                                        },
                                        "resultat": {
                                            "type": "string",
                                            "enum": [
                                                "creee",
                                                "modifiee",
                                                "restauree",
                                                "inchangee",
                                                "doublon"
                                            ]
                                        },
                                        "avertissements": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "signalements": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Signalement"
                                            },
                                            "description": "Ce que Heyalink a remarqué sur l’annonce reçue, sans la refuser : champs ignorés, champs recommandés absents (l’annonce sortira du filtre correspondant), valeurs déduites par l’algorithme de Heyalink, incohérences. Rendu depuis la v1.6.0."
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Créée, ou revenue en ligne.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "formation",
                                        "resultat",
                                        "avertissements"
                                    ],
                                    "properties": {
                                        "formation": {
                                            "$ref": "#/components/schemas/FormationPubliee"
                                        },
                                        "resultat": {
                                            "type": "string",
                                            "enum": [
                                                "creee",
                                                "modifiee",
                                                "restauree",
                                                "inchangee",
                                                "doublon"
                                            ]
                                        },
                                        "avertissements": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "signalements": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Signalement"
                                            },
                                            "description": "Ce que Heyalink a remarqué sur l’annonce reçue, sans la refuser : champs ignorés, champs recommandés absents (l’annonce sortira du filtre correspondant), valeurs déduites par l’algorithme de Heyalink, incohérences. Rendu depuis la v1.6.0."
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationSupprimer",
                "summary": "Supprimer (un PUT la ramène)",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Supprimée, ou déjà absente."
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}/archivage": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationArchiver",
                "summary": "Archiver",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "formation"
                                    ],
                                    "properties": {
                                        "formation": {
                                            "$ref": "#/components/schemas/FormationPubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}/pourvue": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationPourvue",
                "summary": "Marquer pourvue",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "formation"
                                    ],
                                    "properties": {
                                        "formation": {
                                            "$ref": "#/components/schemas/FormationPubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}/fermer": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationFermer",
                "summary": "Fermer (l’annonce ne reçoit plus de réponses)",
                "description": "Depuis la v1.11.0 (07/11/2026). L’annonce sort des listes et de la limite de votre formule ; elle reste lisible par ceux qui ont répondu, qui sont prévenus. État `fermee`, webhook `annonce.fermee`. Elle se rouvre par `…/rouvrir`.",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "formation"
                                    ],
                                    "properties": {
                                        "formation": {
                                            "$ref": "#/components/schemas/FormationPubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}/rouvrir": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationRouvrir",
                "summary": "Rouvrir une annonce fermée",
                "description": "Depuis la v1.11.0. De nouveau en ligne, dans la limite de votre formule : 403 quand elle est atteinte. Webhook `annonce.rouverte`.",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "formation"
                                    ],
                                    "properties": {
                                        "formation": {
                                            "$ref": "#/components/schemas/FormationPubliee"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}/apercu": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "get": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationApercu",
                "summary": "La fiche telle qu’un membre la voit",
                "description": "Depuis la v1.11.0. `fiche` est l’objet que l’application Heyalink affiche, calculé pour un membre quelconque. Une annonce du bac à sable n’a pas de fiche (404).",
                "security": [
                    {
                        "bearer": [
                            "formations:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:lecture"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "reference",
                                        "etat",
                                        "reponses",
                                        "fiche"
                                    ],
                                    "properties": {
                                        "reference": {
                                            "type": "string"
                                        },
                                        "etat": {
                                            "type": "string"
                                        },
                                        "reponses": {
                                            "type": "integer",
                                            "description": "Le nombre de personnes qui ont répondu."
                                        },
                                        "fiche": {
                                            "type": "object"
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}/pieces": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "post": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationPiecesAjouter",
                "summary": "Joindre des photos et des PDF",
                "description": "Depuis la v1.12.0. `photos` : 6 au plus au total (JPEG, PNG, WebP, HEIC, 10 Mo chacune), la première est le visuel de l’annonce et de son partage ; `documents` : 6 PDF au plus au total (20 Mo chacun). Chaque fichier est `{nom, donnees}` (base64, avec ou sans `data:…;base64,`). Chaque pièce est lue par la modération avant d’être montrée aux membres (`statut` `verification`) ; refusée, elle déclenche le webhook `annonce.piece_refusee`. Une annonce importée n’en porte pas (403). Le bac à sable n’en garde pas.",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "photos": {
                                        "type": "array",
                                        "maxItems": 6,
                                        "items": {
                                            "type": "object",
                                            "required": [
                                                "donnees"
                                            ],
                                            "properties": {
                                                "nom": {
                                                    "type": "string"
                                                },
                                                "donnees": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "documents": {
                                        "type": "array",
                                        "maxItems": 6,
                                        "items": {
                                            "type": "object",
                                            "required": [
                                                "donnees"
                                            ],
                                            "properties": {
                                                "nom": {
                                                    "type": "string"
                                                },
                                                "donnees": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Les pièces de l’annonce, dans l’ordre.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "media"
                                    ],
                                    "properties": {
                                        "media": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PieceDAnnonce"
                                            }
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}/pieces/ordre": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                }
            ],
            "put": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationPiecesRanger",
                "summary": "Ranger les photos",
                "description": "Depuis la v1.12.0. `ordre` : les identifiants des photos dans l’ordre voulu ; celles qui manquent suivent, dans leur ordre d’avant. La première devient le visuel.",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "ordre"
                                ],
                                "properties": {
                                    "ordre": {
                                        "type": "array",
                                        "items": {
                                            "type": "integer"
                                        }
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "media"
                                    ],
                                    "properties": {
                                        "media": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/PieceDAnnonce"
                                            }
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/{reference}/pieces/{piece}": {
            "parameters": [
                {
                    "name": "reference",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[\\w.\\-:]{1,191}$",
                        "examples": [
                            "CACES-R482-B1"
                        ]
                    },
                    "description": "Votre référence de l’annonce."
                },
                {
                    "name": "piece",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    }
                }
            ],
            "delete": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationPiecesRetirer",
                "summary": "Retirer une photo ou un PDF",
                "description": "Depuis la v1.12.0. Le fichier est effacé.",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Retirée."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/lot": {
            "post": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationsLot",
                "summary": "Envoyer jusqu’à 100 annonces et retraits",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "formations": {
                                        "type": "array",
                                        "maxItems": 100,
                                        "items": {
                                            "$ref": "#/components/schemas/Formation"
                                        }
                                    },
                                    "retirer": {
                                        "type": "array",
                                        "maxItems": 100,
                                        "items": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "bilan",
                                        "resultats",
                                        "retraits"
                                    ],
                                    "properties": {
                                        "bilan": {
                                            "type": "object",
                                            "required": [
                                                "creees",
                                                "modifiees",
                                                "inchangees",
                                                "doublons",
                                                "retirees",
                                                "refusees"
                                            ],
                                            "properties": {
                                                "creees": {
                                                    "type": "integer"
                                                },
                                                "modifiees": {
                                                    "type": "integer"
                                                },
                                                "inchangees": {
                                                    "type": "integer"
                                                },
                                                "doublons": {
                                                    "type": "integer"
                                                },
                                                "retirees": {
                                                    "type": "integer"
                                                },
                                                "refusees": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "resultats": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "required": [
                                                    "index",
                                                    "statut"
                                                ],
                                                "properties": {
                                                    "index": {
                                                        "type": "integer"
                                                    },
                                                    "reference": {
                                                        "type": [
                                                            "string",
                                                            "null"
                                                        ]
                                                    },
                                                    "statut": {
                                                        "type": "integer",
                                                        "enum": [
                                                            200,
                                                            201,
                                                            409,
                                                            422
                                                        ]
                                                    },
                                                    "code": {
                                                        "type": "string",
                                                        "description": "`annonce_supprimee` (409) : supprimée sur Heyalink par un gérant, la référence ne la ramène pas."
                                                    },
                                                    "resultat": {
                                                        "type": "string"
                                                    },
                                                    "formation": {
                                                        "$ref": "#/components/schemas/FormationPubliee"
                                                    },
                                                    "avertissements": {
                                                        "type": "array",
                                                        "items": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "signalements": {
                                                        "type": "array",
                                                        "items": {
                                                            "$ref": "#/components/schemas/Signalement"
                                                        },
                                                        "description": "Ce que Heyalink a remarqué sur l’annonce reçue, sans la refuser : champs ignorés, champs recommandés absents (l’annonce sortira du filtre correspondant), valeurs déduites par l’algorithme de Heyalink, incohérences. Rendu depuis la v1.6.0."
                                                    },
                                                    "message": {
                                                        "type": "string"
                                                    },
                                                    "errors": {
                                                        "type": "object"
                                                    },
                                                    "violations": {
                                                        "type": "array",
                                                        "items": {
                                                            "$ref": "#/components/schemas/Violation"
                                                        }
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "retraits": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "required": [
                                                    "reference",
                                                    "retiree"
                                                ],
                                                "properties": {
                                                    "reference": {
                                                        "type": "string"
                                                    },
                                                    "retiree": {
                                                        "type": "boolean"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/synchronisation": {
            "post": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationsSynchronisation",
                "summary": "Synchronisation complète : ce qui manque est archivé",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "references"
                                ],
                                "properties": {
                                    "references": {
                                        "type": "array",
                                        "maxItems": 5000,
                                        "items": {
                                            "type": "string"
                                        }
                                    },
                                    "confirmer_liste_vide": {
                                        "type": "boolean"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "bilan"
                                    ],
                                    "properties": {
                                        "bilan": {
                                            "type": "object",
                                            "required": [
                                                "references_recues",
                                                "archivees"
                                            ],
                                            "properties": {
                                                "references_recues": {
                                                    "type": "integer"
                                                },
                                                "archivees": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formations/lheo": {
            "post": {
                "tags": [
                    "Formations"
                ],
                "operationId": "formationsLheo",
                "summary": "Envoyer un catalogue LHEO tel quel",
                "security": [
                    {
                        "bearer": [
                            "formations:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "formations:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "synchronisation",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "complete"
                            ]
                        }
                    },
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/xml": {
                            "schema": {
                                "type": "string"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "bilan"
                                    ],
                                    "properties": {
                                        "bilan": {
                                            "$ref": "#/components/schemas/BilanDeSource"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "Corps trop lourd (5 Mo au plus).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sous-traitance": {
            "get": {
                "tags": [
                    "Sous-traitance"
                ],
                "operationId": "sousTraitanceLister",
                "summary": "Lister les demandes de sous-traitance de votre page",
                "security": [
                    {
                        "bearer": [
                            "sous_traitance:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "sous_traitance:lecture"
                        ]
                    }
                ],
                "description": "Ouvertes, fermées et retenues par la modération ; celles publiées sur le site et dans l’appli aussi. Les plus récentes d’abord, par curseur.",
                "parameters": [
                    {
                        "name": "limite",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 100
                        }
                    },
                    {
                        "name": "curseur",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Le curseur `suivant` de la page précédente."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "demandes",
                                        "suivant",
                                        "limite"
                                    ],
                                    "properties": {
                                        "demandes": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/DemandeDeSousTraitance"
                                            }
                                        },
                                        "suivant": {
                                            "type": [
                                                "string",
                                                "null"
                                            ]
                                        },
                                        "limite": {
                                            "type": "integer"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Rien n’a changé (If-None-Match)."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Sous-traitance"
                ],
                "operationId": "sousTraitancePublier",
                "summary": "Publier une demande de sous-traitance au nom de votre page",
                "description": "Les règles du site : tous les blocs obligatoires (intitulé, métier, lieu, début et durée, description) ; budget et garanties facultatifs ; sans budget, « À discuter ». La demande paraît au nom de la page, publiée par son titulaire, avec sa publication dans le fil. Les photos et les documents s’ajoutent sur Heyalink. Au-delà des demandes ouvertes que permet la formule de la page : 403. `dry_run` et le bac à sable vérifient tout et n’écrivent rien (`id` nul).",
                "security": [
                    {
                        "bearer": [
                            "sous_traitance:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "sous_traitance:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DemandeDeSousTraitanceRecue"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Publiée.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "demande"
                                    ],
                                    "properties": {
                                        "demande": {
                                            "$ref": "#/components/schemas/DemandeDeSousTraitance"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "200": {
                        "description": "Simulée : rien n’est écrit.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "demande"
                                    ],
                                    "properties": {
                                        "demande": {
                                            "$ref": "#/components/schemas/DemandeDeSousTraitance"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sous-traitance/{demande}": {
            "parameters": [
                {
                    "name": "demande",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    },
                    "description": "L’identifiant Heyalink de la demande (`id`)."
                }
            ],
            "get": {
                "tags": [
                    "Sous-traitance"
                ],
                "operationId": "sousTraitanceLire",
                "summary": "Lire une demande et son état",
                "security": [
                    {
                        "bearer": [
                            "sous_traitance:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "sous_traitance:lecture"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "demande"
                                    ],
                                    "properties": {
                                        "demande": {
                                            "$ref": "#/components/schemas/DemandeDeSousTraitance"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "304": {
                        "description": "Rien n’a changé (If-None-Match)."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Sous-traitance"
                ],
                "operationId": "sousTraitanceModifier",
                "summary": "Modifier une demande, bloc par bloc",
                "description": "Seuls les blocs dont un champ est envoyé changent, et chacun s’envoie entier, comme sur le site : `titre` ; `metier` (`metier_code`, `secteur_code`) ; le lieu (`ville`, `pays_code`, `commune_insee`, `code_postal`, `latitude`, `longitude`) ; `debut`, `debut_le`, `duree_nombre`, `duree_unite`, `duree_precision` ; `description` ; le budget (`budget_mode`, `budget_montant`, `budget_unite`, `budget_precision`) ; les garanties (`decennale`, `rc_pro`, `garantie_autre`). Rien à modifier : 422.",
                "security": [
                    {
                        "bearer": [
                            "sous_traitance:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "sous_traitance:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DemandeDeSousTraitanceModifiee"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "demande"
                                    ],
                                    "properties": {
                                        "demande": {
                                            "$ref": "#/components/schemas/DemandeDeSousTraitance"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Sous-traitance"
                ],
                "operationId": "sousTraitanceSupprimer",
                "summary": "Supprimer, définitivement",
                "description": "Sa publication part avec ses questions ; les candidats en cours sont prévenus. Webhook `sous_traitance.supprimee`.",
                "security": [
                    {
                        "bearer": [
                            "sous_traitance:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "sous_traitance:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Supprimée."
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sous-traitance/{demande}/fermer": {
            "parameters": [
                {
                    "name": "demande",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    },
                    "description": "L’identifiant Heyalink de la demande (`id`)."
                }
            ],
            "post": {
                "tags": [
                    "Sous-traitance"
                ],
                "operationId": "sousTraitanceFermer",
                "summary": "Fermer (la demande ne reçoit plus de candidatures)",
                "description": "Elle sort des listes et libère sa place dans la limite de la formule ; elle reste lisible ; les candidats en cours sont prévenus. État `fermee`, webhook `sous_traitance.fermee`.",
                "security": [
                    {
                        "bearer": [
                            "sous_traitance:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "sous_traitance:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "demande"
                                    ],
                                    "properties": {
                                        "demande": {
                                            "$ref": "#/components/schemas/DemandeDeSousTraitance"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sous-traitance/{demande}/rouvrir": {
            "parameters": [
                {
                    "name": "demande",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    },
                    "description": "L’identifiant Heyalink de la demande (`id`)."
                }
            ],
            "post": {
                "tags": [
                    "Sous-traitance"
                ],
                "operationId": "sousTraitanceRouvrir",
                "summary": "Rouvrir une demande fermée",
                "description": "Dans la limite de la formule de la page : 403 quand elle est atteinte. Webhook `sous_traitance.rouverte`.",
                "security": [
                    {
                        "bearer": [
                            "sous_traitance:ecriture"
                        ]
                    },
                    {
                        "oauth2": [
                            "sous_traitance:ecriture"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "maxLength": 255
                        },
                        "description": "Rejouée dans les 24 heures, la même requête rend la même réponse sans rien refaire."
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "true"
                            ]
                        },
                        "description": "Validation à blanc : tout est vérifié, la réponse est celle d’une vraie écriture avec `simulation: true`, rien n’est écrit. Aussi par l’en-tête `Heyalink-Simulation: 1`."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "demande"
                                    ],
                                    "properties": {
                                        "demande": {
                                            "$ref": "#/components/schemas/DemandeDeSousTraitance"
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "simulation": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour un `dry_run` : rien n’est écrit."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "La même Idempotency-Key est encore en cours.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sous-traitance/{demande}/candidatures": {
            "parameters": [
                {
                    "name": "demande",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    },
                    "description": "L’identifiant Heyalink de la demande (`id`)."
                }
            ],
            "get": {
                "tags": [
                    "Sous-traitance"
                ],
                "operationId": "sousTraitanceCandidatures",
                "summary": "Les candidatures reçues, en lecture",
                "description": "La plus récente d’abord ; ni celles de membres bloqués, ni celles retenues par la modération. Retenir ou ne pas retenir reste un geste du gérant, sur Heyalink ; la lecture par l’API ne les marque pas vues. Les pièces se téléchargent sur Heyalink (`pieces` en donne le nombre).",
                "security": [
                    {
                        "bearer": [
                            "sous_traitance:lecture"
                        ]
                    },
                    {
                        "oauth2": [
                            "sous_traitance:lecture"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "candidatures"
                                    ],
                                    "properties": {
                                        "candidatures": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CandidatureDeSousTraitance"
                                            }
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/moi": {
            "get": {
                "tags": [
                    "Compte"
                ],
                "operationId": "moi",
                "summary": "Vérifier la clé : sa page, son API, ses droits",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "entreprise",
                                        "cle",
                                        "limites"
                                    ],
                                    "properties": {
                                        "entreprise": {
                                            "type": "object",
                                            "required": [
                                                "nom",
                                                "adresse"
                                            ],
                                            "properties": {
                                                "nom": {
                                                    "type": "string"
                                                },
                                                "adresse": {
                                                    "type": "string",
                                                    "format": "uri"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "cle": {
                                            "type": "object",
                                            "required": [
                                                "nom",
                                                "api",
                                                "debut",
                                                "droits",
                                                "creee_le"
                                            ],
                                            "properties": {
                                                "nom": {
                                                    "type": "string"
                                                },
                                                "api": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ],
                                                    "enum": [
                                                        "emploi",
                                                        "formation",
                                                        null
                                                    ],
                                                    "description": "L’API de la clé ; nulle pour une clé d’avant le 21/10/2026."
                                                },
                                                "debut": {
                                                    "type": "string"
                                                },
                                                "droits": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "string",
                                                        "enum": [
                                                            "offres:lecture",
                                                            "offres:ecriture",
                                                            "sous_traitance:lecture",
                                                            "sous_traitance:ecriture",
                                                            "formations:lecture",
                                                            "formations:ecriture"
                                                        ]
                                                    }
                                                },
                                                "creee_le": {
                                                    "type": [
                                                        "string",
                                                        "null"
                                                    ],
                                                    "format": "date-time"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "limites": {
                                            "type": "object",
                                            "required": [
                                                "appels_par_minute",
                                                "annonces_par_lot"
                                            ],
                                            "properties": {
                                                "appels_par_minute": {
                                                    "type": "integer"
                                                },
                                                "annonces_par_lot": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/journal": {
            "get": {
                "tags": [
                    "Compte"
                ],
                "operationId": "journal",
                "summary": "Les 100 derniers appels et lectures (le journal de test pour une clé d’essai)",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "journal"
                                    ],
                                    "properties": {
                                        "journal": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "required": [
                                                    "le",
                                                    "source",
                                                    "appel",
                                                    "statut"
                                                ],
                                                "properties": {
                                                    "le": {
                                                        "type": "string",
                                                        "format": "date-time"
                                                    },
                                                    "source": {
                                                        "type": "string"
                                                    },
                                                    "appel": {
                                                        "type": "string"
                                                    },
                                                    "reference": {
                                                        "type": [
                                                            "string",
                                                            "null"
                                                        ]
                                                    },
                                                    "statut": {
                                                        "type": "integer"
                                                    },
                                                    "message": {
                                                        "type": [
                                                            "string",
                                                            "null"
                                                        ]
                                                    },
                                                    "duree_ms": {
                                                        "type": [
                                                            "integer",
                                                            "null"
                                                        ]
                                                    },
                                                    "requete": {
                                                        "type": [
                                                            "string",
                                                            "null"
                                                        ],
                                                        "description": "Journal de test seulement : la requête complète, secrets masqués."
                                                    },
                                                    "reponse": {
                                                        "type": [
                                                            "string",
                                                            "null"
                                                        ],
                                                        "description": "Journal de test seulement : la réponse complète, secrets masqués."
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "bac_a_sable": {
                                            "type": "boolean",
                                            "description": "Présent (vrai) pour une clé d’essai : rien n’est publié."
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mcp": {
            "post": {
                "tags": [
                    "Compte"
                ],
                "operationId": "mcp",
                "summary": "Serveur MCP (Model Context Protocol, JSON-RPC 2.0) pour les agents d’IA",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "jsonrpc",
                                    "method"
                                ],
                                "properties": {
                                    "jsonrpc": {
                                        "type": "string",
                                        "enum": [
                                            "2.0"
                                        ]
                                    },
                                    "id": {
                                        "type": [
                                            "string",
                                            "integer"
                                        ]
                                    },
                                    "method": {
                                        "type": "string"
                                    },
                                    "params": {
                                        "type": "object"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "jsonrpc"
                                    ],
                                    "properties": {
                                        "jsonrpc": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": [
                                                "string",
                                                "integer",
                                                "null"
                                            ]
                                        },
                                        "result": {
                                            "type": "object"
                                        },
                                        "error": {
                                            "type": "object"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Notification reçue."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/domaines": {
            "get": {
                "tags": [
                    "Compte"
                ],
                "operationId": "domaines",
                "summary": "Les domaines de votre page et leur preuve",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "domaines"
                                    ],
                                    "properties": {
                                        "domaines": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Domaine"
                                            }
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Compte"
                ],
                "operationId": "domaineAjouter",
                "summary": "Ajouter un domaine à prouver : le jeton à poser sur votre site",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "domaine"
                                ],
                                "properties": {
                                    "domaine": {
                                        "type": "string",
                                        "examples": [
                                            "votre-site.fr"
                                        ]
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "domaine",
                                        "instructions"
                                    ],
                                    "properties": {
                                        "domaine": {
                                            "$ref": "#/components/schemas/Domaine"
                                        },
                                        "instructions": {
                                            "type": "object",
                                            "required": [
                                                "meta",
                                                "fichier"
                                            ],
                                            "properties": {
                                                "meta": {
                                                    "type": "string"
                                                },
                                                "fichier": {
                                                    "type": "string",
                                                    "format": "uri"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Requête mal formée (Idempotency-Key trop longue…).",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/domaines/{domaine}/verification": {
            "parameters": [
                {
                    "name": "domaine",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[a-z0-9.\\-]{4,191}$"
                    }
                }
            ],
            "post": {
                "tags": [
                    "Compte"
                ],
                "operationId": "domaineVerifier",
                "summary": "Chercher la preuve sur votre site (balise meta ou /.well-known/heyalink.txt)",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "domaine"
                                    ],
                                    "properties": {
                                        "domaine": {
                                            "$ref": "#/components/schemas/Domaine"
                                        },
                                        "message": {
                                            "type": "string"
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/domaines/{domaine}": {
            "parameters": [
                {
                    "name": "domaine",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[a-z0-9.\\-]{4,191}$"
                    }
                }
            ],
            "delete": {
                "tags": [
                    "Compte"
                ],
                "operationId": "domaineRetirer",
                "summary": "Retirer un domaine",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Retiré."
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/oauth/token": {
            "post": {
                "tags": [
                    "Compte"
                ],
                "operationId": "jeton",
                "summary": "OAuth 2.0, client credentials : un jeton d’une heure",
                "security": [],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "grant_type"
                                ],
                                "properties": {
                                    "grant_type": {
                                        "type": "string",
                                        "enum": [
                                            "client_credentials"
                                        ]
                                    },
                                    "client_id": {
                                        "type": "string"
                                    },
                                    "client_secret": {
                                        "type": "string"
                                    },
                                    "scope": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "access_token",
                                        "token_type",
                                        "expires_in",
                                        "scope"
                                    ],
                                    "properties": {
                                        "access_token": {
                                            "type": "string"
                                        },
                                        "token_type": {
                                            "type": "string",
                                            "enum": [
                                                "Bearer"
                                            ]
                                        },
                                        "expires_in": {
                                            "type": "integer"
                                        },
                                        "scope": {
                                            "type": "string"
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Erreur OAuth (RFC 6749, 5.2).",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErreurOAuth"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Client inconnu, révoqué ou expiré.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErreurOAuth"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’échanges : 30 par minute et par adresse."
                    }
                }
            }
        },
        "/openapi.json": {
            "get": {
                "tags": [
                    "Compte"
                ],
                "operationId": "specification",
                "summary": "Cette spécification",
                "security": [],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sante": {
            "get": {
                "tags": [
                    "Compte"
                ],
                "operationId": "sante",
                "summary": "L’état de l’API (public)",
                "security": [],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Sante"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "L’API est dégradée.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Sante"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sources/{source}/relire/{signature}": {
            "parameters": [
                {
                    "name": "source",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    }
                },
                {
                    "name": "signature",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[0-9a-f]{64}$"
                    }
                }
            ],
            "get": {
                "tags": [
                    "Sources"
                ],
                "operationId": "sourceRelire",
                "summary": "Relire la source tout de suite",
                "security": [],
                "responses": {
                    "202": {
                        "description": "Relecture planifiée.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "relecture"
                                    ],
                                    "properties": {
                                        "relecture": {
                                            "type": "string",
                                            "enum": [
                                                "planifiee",
                                                "deja_demandee"
                                            ]
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Source ou signature inconnue."
                    }
                }
            },
            "post": {
                "tags": [
                    "Sources"
                ],
                "operationId": "sourceRelirePost",
                "summary": "Relire la source tout de suite",
                "security": [],
                "responses": {
                    "202": {
                        "description": "Relecture planifiée.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "relecture"
                                    ],
                                    "properties": {
                                        "relecture": {
                                            "type": "string",
                                            "enum": [
                                                "planifiee",
                                                "deja_demandee"
                                            ]
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Source ou signature inconnue."
                    }
                }
            }
        },
        "/sources/{source}/greenhouse/{signature}": {
            "parameters": [
                {
                    "name": "source",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    }
                },
                {
                    "name": "signature",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[0-9a-f]{64}$"
                    }
                }
            ],
            "post": {
                "tags": [
                    "Sources"
                ],
                "operationId": "sourceGreenhouse",
                "summary": "Webhook de Greenhouse (signature vérifiée)",
                "security": [],
                "responses": {
                    "202": {
                        "description": "Relecture planifiée.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "relecture"
                                    ],
                                    "properties": {
                                        "relecture": {
                                            "type": "string",
                                            "enum": [
                                                "planifiee",
                                                "deja_demandee"
                                            ]
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Source ou signature inconnue."
                    }
                }
            }
        },
        "/sources/{source}/websub/{signature}": {
            "parameters": [
                {
                    "name": "source",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "integer"
                    }
                },
                {
                    "name": "signature",
                    "in": "path",
                    "required": true,
                    "schema": {
                        "type": "string",
                        "pattern": "^[0-9a-f]{64}$"
                    }
                }
            ],
            "get": {
                "tags": [
                    "Sources"
                ],
                "operationId": "sourceWebsubVerifier",
                "summary": "Vérification d’abonnement WebSub",
                "security": [],
                "responses": {
                    "200": {
                        "description": "Le défi du hub.",
                        "content": {
                            "text/plain": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Source ou signature inconnue."
                    }
                }
            },
            "post": {
                "tags": [
                    "Sources"
                ],
                "operationId": "sourceWebsubNotifier",
                "summary": "Notification WebSub (signature vérifiée)",
                "security": [],
                "responses": {
                    "202": {
                        "description": "Relecture planifiée.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "relecture"
                                    ],
                                    "properties": {
                                        "relecture": {
                                            "type": "string",
                                            "enum": [
                                                "planifiee",
                                                "deja_demandee"
                                            ]
                                        },
                                        "success": {
                                            "type": "boolean",
                                            "const": true
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Source ou signature inconnue."
                    }
                }
            }
        },
        "/services": {
            "get": {
                "tags": [
                    "Services"
                ],
                "operationId": "listerLesServices",
                "summary": "Les services de la page : brouillons, en ligne, fermés",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "donnees": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ServiceBlocParBloc"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Services"
                ],
                "operationId": "creerUnService",
                "summary": "Créer un service en brouillon (type et title facultatifs : ils remplissent la tête)",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "type": {
                                        "type": "string",
                                        "enum": [
                                            "prestation",
                                            "bien",
                                            "produit",
                                            "reseau_evenement"
                                        ]
                                    },
                                    "title": {
                                        "type": "string",
                                        "maxLength": 120
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "service": {
                                            "$ref": "#/components/schemas/ServiceBlocParBloc"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/services/{id}": {
            "get": {
                "tags": [
                    "Services"
                ],
                "operationId": "lireUnService",
                "summary": "Un service : son état, ses blocs, ce qui manque avant de publier",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "L’identifiant du service (sa référence dans les webhooks)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "service": {
                                            "$ref": "#/components/schemas/ServiceBlocParBloc"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Services"
                ],
                "operationId": "supprimerUnService",
                "summary": "Supprimer le service (définitif ; webhook annonce.supprimee)",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "L’identifiant du service (sa référence dans les webhooks)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "message": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/services/{id}/blocs/{bloc}": {
            "patch": {
                "tags": [
                    "Services"
                ],
                "operationId": "enregistrerUnBloc",
                "summary": "Enregistrer un bloc : seuls ses champs changent",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "L’identifiant du service (sa référence dans les webhooks)."
                    },
                    {
                        "name": "bloc",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "entete",
                                "description",
                                "details",
                                "metier",
                                "zone",
                                "prix",
                                "photos",
                                "documents",
                                "devis"
                            ]
                        },
                        "description": "entete (type, title) ; description ; details (details[…], bien, produit, réseau) ; metier (activity, metiers_proches[] : deux au plus) ; zone (zone : rayon, france ou departements ; location, latitude, longitude, radius ; departements[]) ; prix (prix_mode : a_partir_de ou sur_devis, gratuit ou membres pour un réseau ; prix_montant, prix_unite, prix_taxe) ; photos (photos[] : 6 au plus, 10 Mo ; photos_retirer[]) ; documents (documents[] : 6 PDF au plus, 20 Mo ; documents_retirer[]) ; devis (demandes_de_devis)."
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object"
                            }
                        },
                        "multipart/form-data": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "service": {
                                            "$ref": "#/components/schemas/ServiceBlocParBloc"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Services"
                ],
                "operationId": "envoyerUnBloc",
                "summary": "Enregistrer un bloc en multipart (photos, PDF) : comme PATCH",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "L’identifiant du service (sa référence dans les webhooks)."
                    },
                    {
                        "name": "bloc",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "entete",
                                "description",
                                "details",
                                "metier",
                                "zone",
                                "prix",
                                "photos",
                                "documents",
                                "devis"
                            ]
                        },
                        "description": "entete (type, title) ; description ; details (details[…], bien, produit, réseau) ; metier (activity, metiers_proches[] : deux au plus) ; zone (zone : rayon, france ou departements ; location, latitude, longitude, radius ; departements[]) ; prix (prix_mode : a_partir_de ou sur_devis, gratuit ou membres pour un réseau ; prix_montant, prix_unite, prix_taxe) ; photos (photos[] : 6 au plus, 10 Mo ; photos_retirer[]) ; documents (documents[] : 6 PDF au plus, 20 Mo ; documents_retirer[]) ; devis (demandes_de_devis)."
                    }
                ],
                "requestBody": {
                    "content": {
                        "multipart/form-data": {
                            "schema": {
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "service": {
                                            "$ref": "#/components/schemas/ServiceBlocParBloc"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/services/{id}/apercu": {
            "get": {
                "tags": [
                    "Services"
                ],
                "operationId": "apercuDUnService",
                "summary": "Voir comme un membre : ce que la fiche montre",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "L’identifiant du service (sa référence dans les webhooks)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "apercu": {
                                            "type": "object"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/services/{id}/publication": {
            "post": {
                "tags": [
                    "Services"
                ],
                "operationId": "publierUnService",
                "summary": "Publier le service (tous les blocs obligatoires remplis, dans la limite de la formule)",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "L’identifiant du service (sa référence dans les webhooks)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "service": {
                                            "$ref": "#/components/schemas/ServiceBlocParBloc"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/services/{id}/fermeture": {
            "post": {
                "tags": [
                    "Services"
                ],
                "operationId": "fermerUnService",
                "summary": "Fermer le service : il sort des listes et du plafond (webhook annonce.fermee)",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "L’identifiant du service (sa référence dans les webhooks)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "service": {
                                            "$ref": "#/components/schemas/ServiceBlocParBloc"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/services/{id}/reouverture": {
            "post": {
                "tags": [
                    "Services"
                ],
                "operationId": "rouvrirUnService",
                "summary": "Rouvrir le service, dans la limite de la formule (webhook annonce.rouverte)",
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "oauth2": []
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "description": "L’identifiant du service (sa référence dans les webhooks)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Succès.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "service": {
                                            "$ref": "#/components/schemas/ServiceBlocParBloc"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Clé absente, inconnue, révoquée ou expirée.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Droit manquant, adresse IP refusée, ou page sans accès.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Référence inconnue.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Refusée : `errors` et `violations` champ par champ.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Trop d’appels : voir `Retry-After`.",
                        "content": {
                            "application/problem+json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Probleme"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "webhooks": {
        "evenementDAnnonce": {
            "post": {
                "summary": "Un événement d’une de vos annonces (signé : en-tête Heyalink-Signature)",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/EvenementWebhook"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Bien reçu (tout statut 2xx)."
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "bearer": {
                "type": "http",
                "scheme": "bearer",
                "description": "Une clé `hl_emploi_live_…`, `hl_formation_live_…`, ou un jeton OAuth `hl_at_…`."
            },
            "oauth2": {
                "type": "oauth2",
                "flows": {
                    "clientCredentials": {
                        "tokenUrl": "https://www.heyalink.com/api/entreprises/v1/oauth/token",
                        "scopes": {
                            "offres:lecture": "Lire vos offres",
                            "offres:ecriture": "Publier vos offres",
                            "sous_traitance:lecture": "Lire vos demandes de sous-traitance et leurs candidatures",
                            "sous_traitance:ecriture": "Publier vos demandes de sous-traitance",
                            "formations:lecture": "Lire vos formations",
                            "formations:ecriture": "Publier vos formations"
                        }
                    }
                }
            }
        },
        "schemas": {
            "DemandeDeSousTraitanceRecue": {
                "type": "object",
                "required": [
                    "titre",
                    "metier",
                    "ville",
                    "debut",
                    "duree_nombre",
                    "duree_unite",
                    "description"
                ],
                "properties": {
                    "titre": {
                        "type": "string",
                        "minLength": 5,
                        "maxLength": 80,
                        "description": "Ce que vous cherchez, en une ligne (« Pose de 400 m² de plaques de plâtre »)."
                    },
                    "metier": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 120,
                        "description": "Le métier recherché, en texte."
                    },
                    "metier_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80,
                        "description": "Le code d’un métier du référentiel de Heyalink, s’il est connu."
                    },
                    "secteur_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "ville": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 80,
                        "description": "La commune du chantier ; en France, rangée dans la liste des communes (refusée si elle ne se range pas). Jamais une adresse précise."
                    },
                    "pays_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Le pays (ISO 3166, deux lettres) ; absent, la France."
                    },
                    "latitude": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "longitude": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "commune_insee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 10
                    },
                    "code_postal": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 12
                    },
                    "debut": {
                        "type": "string",
                        "enum": [
                            "date",
                            "des_que_possible"
                        ],
                        "description": "`date` (avec `debut_le`) ou `des_que_possible`."
                    },
                    "debut_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "La date de début (AAAA-MM-JJ), avec `debut` = `date` : aujourd’hui au plus tôt, dans moins de deux ans."
                    },
                    "duree_nombre": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 365,
                        "description": "La durée de la mission, avec `duree_unite`."
                    },
                    "duree_unite": {
                        "type": "string",
                        "enum": [
                            "jours",
                            "semaines",
                            "mois"
                        ],
                        "description": "L’unité de `duree_nombre`."
                    },
                    "duree_precision": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "description": {
                        "type": "string",
                        "minLength": 20,
                        "maxLength": 5000,
                        "description": "La mission en détail : le chantier, les conditions, ce qui est fourni. Jamais de prix demandé aux candidats ici."
                    },
                    "budget_mode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "montant",
                            "a_discuter",
                            null
                        ],
                        "description": "`montant` (avec `budget_montant` et `budget_unite`) ou `a_discuter` ; absent, `a_discuter`."
                    },
                    "budget_montant": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 100000000,
                        "description": "Le budget, en euros hors taxes."
                    },
                    "budget_unite": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "forfait",
                            "jour",
                            "m2",
                            null
                        ],
                        "description": "`forfait`, `jour` ou `m2`."
                    },
                    "budget_precision": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "decennale": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Vrai si l’assurance décennale est exigée des candidats."
                    },
                    "rc_pro": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Vrai si la responsabilité civile professionnelle est exigée."
                    },
                    "garantie_autre": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "description": "Une autre garantie exigée, en texte."
                    }
                },
                "description": "Les champs des blocs du site. Un champ hors de cette liste est ignoré."
            },
            "DemandeDeSousTraitanceModifiee": {
                "type": "object",
                "properties": {
                    "titre": {
                        "type": "string",
                        "minLength": 5,
                        "maxLength": 80,
                        "description": "Ce que vous cherchez, en une ligne (« Pose de 400 m² de plaques de plâtre »)."
                    },
                    "metier": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 120,
                        "description": "Le métier recherché, en texte."
                    },
                    "metier_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80,
                        "description": "Le code d’un métier du référentiel de Heyalink, s’il est connu."
                    },
                    "secteur_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "ville": {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 80,
                        "description": "La commune du chantier ; en France, rangée dans la liste des communes (refusée si elle ne se range pas). Jamais une adresse précise."
                    },
                    "pays_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Le pays (ISO 3166, deux lettres) ; absent, la France."
                    },
                    "latitude": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "longitude": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "commune_insee": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 10
                    },
                    "code_postal": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 12
                    },
                    "debut": {
                        "type": "string",
                        "enum": [
                            "date",
                            "des_que_possible"
                        ],
                        "description": "`date` (avec `debut_le`) ou `des_que_possible`."
                    },
                    "debut_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "La date de début (AAAA-MM-JJ), avec `debut` = `date` : aujourd’hui au plus tôt, dans moins de deux ans."
                    },
                    "duree_nombre": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 365,
                        "description": "La durée de la mission, avec `duree_unite`."
                    },
                    "duree_unite": {
                        "type": "string",
                        "enum": [
                            "jours",
                            "semaines",
                            "mois"
                        ],
                        "description": "L’unité de `duree_nombre`."
                    },
                    "duree_precision": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "description": {
                        "type": "string",
                        "minLength": 20,
                        "maxLength": 5000,
                        "description": "La mission en détail : le chantier, les conditions, ce qui est fourni. Jamais de prix demandé aux candidats ici."
                    },
                    "budget_mode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "montant",
                            "a_discuter",
                            null
                        ],
                        "description": "`montant` (avec `budget_montant` et `budget_unite`) ou `a_discuter` ; absent, `a_discuter`."
                    },
                    "budget_montant": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 100000000,
                        "description": "Le budget, en euros hors taxes."
                    },
                    "budget_unite": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "forfait",
                            "jour",
                            "m2",
                            null
                        ],
                        "description": "`forfait`, `jour` ou `m2`."
                    },
                    "budget_precision": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 80
                    },
                    "decennale": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Vrai si l’assurance décennale est exigée des candidats."
                    },
                    "rc_pro": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Vrai si la responsabilité civile professionnelle est exigée."
                    },
                    "garantie_autre": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "description": "Une autre garantie exigée, en texte."
                    }
                },
                "description": "Les champs des blocs à modifier ; chaque bloc touché s’envoie entier."
            },
            "DemandeDeSousTraitance": {
                "type": "object",
                "description": "Une demande de sous-traitance de votre page.",
                "required": [
                    "id",
                    "titre",
                    "metier",
                    "metier_code",
                    "secteur_code",
                    "lieu",
                    "pays_code",
                    "debut_le",
                    "duree",
                    "description",
                    "budget",
                    "garanties",
                    "etat",
                    "candidatures",
                    "adresse",
                    "publiee_le",
                    "modifiee_le",
                    "fermee_le"
                ],
                "properties": {
                    "id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Nul pour une simulation."
                    },
                    "titre": {
                        "type": "string"
                    },
                    "metier": {
                        "type": "string"
                    },
                    "metier_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "secteur_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "lieu": {
                        "type": "string",
                        "description": "La commune, rangée par Heyalink."
                    },
                    "pays_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "debut_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Nul : dès que possible."
                    },
                    "duree": {
                        "type": "object",
                        "required": [
                            "nombre",
                            "unite",
                            "precision"
                        ],
                        "properties": {
                            "nombre": {
                                "type": [
                                    "integer",
                                    "null"
                                ]
                            },
                            "unite": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "jours",
                                    "semaines",
                                    "mois",
                                    null
                                ]
                            },
                            "precision": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        },
                        "additionalProperties": false
                    },
                    "description": {
                        "type": "string"
                    },
                    "budget": {
                        "type": "object",
                        "required": [
                            "montant_ht",
                            "unite",
                            "precision"
                        ],
                        "properties": {
                            "montant_ht": {
                                "type": [
                                    "number",
                                    "null"
                                ],
                                "description": "Nul : « À discuter »."
                            },
                            "unite": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "enum": [
                                    "forfait",
                                    "jour",
                                    "m2",
                                    null
                                ]
                            },
                            "precision": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        },
                        "additionalProperties": false
                    },
                    "garanties": {
                        "type": "object",
                        "required": [
                            "decennale",
                            "rc_pro",
                            "autre"
                        ],
                        "properties": {
                            "decennale": {
                                "type": "boolean"
                            },
                            "rc_pro": {
                                "type": "boolean"
                            },
                            "autre": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        },
                        "additionalProperties": false
                    },
                    "etat": {
                        "type": "string",
                        "enum": [
                            "ouverte",
                            "fermee",
                            "masquee_par_la_moderation"
                        ]
                    },
                    "candidatures": {
                        "type": "integer",
                        "description": "Le nombre de candidatures reçues."
                    },
                    "adresse": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri"
                    },
                    "publiee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "modifiee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "fermee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "additionalProperties": false
            },
            "CandidatureDeSousTraitance": {
                "type": "object",
                "description": "Une candidature reçue sur une demande de votre page.",
                "required": [
                    "id",
                    "statut",
                    "message",
                    "prix",
                    "garanties",
                    "pieces",
                    "au_nom_de",
                    "candidat",
                    "envoyee_le",
                    "vue_le",
                    "decidee_le"
                ],
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "statut": {
                        "type": "string",
                        "enum": [
                            "envoyee",
                            "vue",
                            "retenue",
                            "non_retenue",
                            "close"
                        ]
                    },
                    "message": {
                        "type": "string"
                    },
                    "prix": {
                        "type": "object",
                        "required": [
                            "montant_ht",
                            "unite"
                        ],
                        "properties": {
                            "montant_ht": {
                                "type": [
                                    "number",
                                    "null"
                                ]
                            },
                            "unite": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        },
                        "additionalProperties": false
                    },
                    "garanties": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "enum": [
                                "decennale",
                                "rc_pro"
                            ]
                        },
                        "description": "Les garanties exigées que le candidat dit avoir."
                    },
                    "pieces": {
                        "type": "integer",
                        "description": "Le nombre de pièces jointes (PDF), à lire sur Heyalink."
                    },
                    "au_nom_de": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "La page au nom de laquelle le candidat répond."
                    },
                    "candidat": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "additionalProperties": false,
                        "required": [
                            "nom",
                            "metier",
                            "lieu"
                        ],
                        "properties": {
                            "nom": {
                                "type": "string"
                            },
                            "metier": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "lieu": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            }
                        }
                    },
                    "envoyee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "vue_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "decidee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "additionalProperties": false
            },
            "Offre": {
                "type": "object",
                "required": [
                    "titre",
                    "description",
                    "lieu"
                ],
                "properties": {
                    "titre": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "L’intitulé du poste.",
                        "examples": [
                            "Chef de chantier gros œuvre"
                        ]
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 20000,
                        "description": "Le texte de l’offre ; le HTML est accepté : les balises sont retirées, le texte est gardé.",
                        "examples": [
                            "<p>Vous dirigez deux équipes sur des chantiers de logements collectifs.</p>"
                        ]
                    },
                    "lieu": {
                        "type": "string",
                        "maxLength": 255,
                        "description": "La ville ; vide, la ville de votre page.",
                        "examples": [
                            "Toulouse (31)"
                        ]
                    },
                    "code_postal": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^\\d{5}$",
                        "description": "Il range l’offre dans son département.",
                        "examples": [
                            "31000"
                        ]
                    },
                    "type_contrat": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "description": "CDI, CDD, Intérim, Apprentissage, Alternance, Stage ou Saisonnier ; les mots anglais des sites d’emploi sont compris (permanent, temporary, internship…).",
                        "examples": [
                            "CDI"
                        ]
                    },
                    "salaire": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 50,
                        "description": "Le salaire en clair, tel que vous l’affichez.",
                        "examples": [
                            "38 000 € par an"
                        ]
                    },
                    "metier": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "description": "Le métier, en texte ; reconnu, il fait proposer l’offre aux bons membres.",
                        "examples": [
                            "Chef de chantier"
                        ]
                    },
                    "secteur": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "description": "Le secteur d’activité, en texte.",
                        "examples": [
                            "Gros œuvre"
                        ]
                    },
                    "lien_candidature": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "format": "uri",
                        "pattern": "^https://",
                        "description": "L’adresse où postuler chez vous, sur un domaine prouvé de votre page ; absente, on postule sur Heyalink.",
                        "examples": [
                            "https://www.votre-site.fr/offres/CC-2026-014"
                        ]
                    },
                    "date_expiration": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Ignoré depuis le 07/11/2026 (v1.10.0) : facultatif, accepté mais sans effet. Une offre n’a plus de date de fin : elle reste en ligne jusqu’à ce que vous l’archiviez.",
                        "examples": [
                            "2026-12-31"
                        ]
                    },
                    "metier_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "pattern": "^[a-z0-9][a-z0-9\\-]{0,63}$",
                        "description": "Le code d’un métier du référentiel de Heyalink. Inconnu : refusé (422). Sans lui, Heyalink déduit le métier du code ROME, de `metier` ou de l’intitulé.",
                        "examples": [
                            "chef-de-chantier-batiment"
                        ]
                    },
                    "famille_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "pattern": "^[a-z0-9][a-z0-9\\-]{0,63}$",
                        "description": "Le code d’une des 39 familles de métiers de Heyalink. Sans lui, la famille du métier.",
                        "examples": [
                            "entreprise-generale"
                        ]
                    },
                    "code_rome": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^[A-N]\\d{4}$",
                        "description": "Le code ROME de France Travail (une lettre, quatre chiffres).",
                        "examples": [
                            "F1202"
                        ]
                    },
                    "experience_mois": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 600,
                        "description": "L’expérience demandée, en mois ; 0 pour un débutant accepté.",
                        "examples": [
                            36
                        ]
                    },
                    "temps_de_travail": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "plein",
                            "partiel",
                            null
                        ],
                        "description": "Le temps de travail. Un `type_contrat` FULL_TIME ou PART_TIME le donne aussi.",
                        "examples": [
                            "plein"
                        ]
                    },
                    "teletravail": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "non",
                            "partiel",
                            "total",
                            null
                        ],
                        "description": "Le télétravail : non, partiel (hybride) ou total.",
                        "examples": [
                            "non"
                        ]
                    },
                    "alternance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "apprentissage",
                            "professionnalisation",
                            null
                        ],
                        "description": "Le ou les contrats d’alternance.",
                        "examples": [
                            "apprentissage"
                        ]
                    },
                    "salaire_min": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 10000000,
                        "description": "Le bas de la fourchette de salaire brut, en euros, pour `salaire_periode`.",
                        "examples": [
                            36000
                        ]
                    },
                    "salaire_max": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 10000000,
                        "description": "Le haut de la fourchette, au moins égal à `salaire_min`.",
                        "examples": [
                            40000
                        ]
                    },
                    "salaire_periode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "heure",
                            "jour",
                            "semaine",
                            "mois",
                            "an",
                            null
                        ],
                        "description": "L’unité de temps de `salaire_min` et `salaire_max` ; obligatoire avec l’un des deux.",
                        "examples": [
                            "an"
                        ]
                    },
                    "description_poste": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 10000,
                        "description": "v1.9.0 : le bloc « Le poste » de la fiche, en texte (une ligne par paragraphe, « - » en tête d’une puce). Facultatif ; avec les blocs, la fiche les montre à la place de `description`, qui reste exigée.",
                        "examples": [
                            "Rejoignez une équipe de six compagnons sur des chantiers de logements à Toulouse."
                        ]
                    },
                    "description_missions": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 10000,
                        "description": "v1.9.0 : le bloc « Les missions » de la fiche, même forme que `description_poste`.",
                        "examples": [
                            "- Organiser le chantier et les approvisionnements\n- Encadrer deux équipes"
                        ]
                    },
                    "description_profil": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 10000,
                        "description": "v1.9.0 : le bloc « Le profil » de la fiche, même forme que `description_poste`.",
                        "examples": [
                            "- Trois ans d’expérience en gros œuvre\n- Lecture de plans"
                        ]
                    },
                    "description_avantages": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 10000,
                        "description": "v1.9.0 : le bloc « Les avantages » de la fiche, même forme que `description_poste`.",
                        "examples": [
                            "- Véhicule de service\n- Panier repas"
                        ]
                    },
                    "duree_nombre": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 999,
                        "description": "v1.9.0 : la durée du contrat (CDD, intérim, saisonnier), avec `duree_unite`. La fiche l’écrit « Intérim, 18 mois ».",
                        "examples": [
                            6
                        ]
                    },
                    "duree_unite": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "jours",
                            "semaines",
                            "mois",
                            null
                        ],
                        "description": "v1.9.0 : l’unité de `duree_nombre` ; obligatoire avec lui.",
                        "examples": [
                            "mois"
                        ]
                    }
                },
                "description": "Un champ hors de cette liste n’est jamais publié ni refusé : il est ignoré, et la réponse le signale (`signalements`, code `champ_ignore`)."
            },
            "Formation": {
                "type": "object",
                "required": [
                    "titre",
                    "presentation",
                    "lien"
                ],
                "properties": {
                    "titre": {
                        "type": "string",
                        "maxLength": 200,
                        "description": "L’intitulé de la formation.",
                        "examples": [
                            "CACES R482 catégorie B1"
                        ]
                    },
                    "presentation": {
                        "type": "string",
                        "maxLength": 15000,
                        "description": "Le contenu de la formation ; le HTML est accepté : les balises sont retirées, le texte est gardé.",
                        "examples": [
                            "Conduite en sécurité des pelles hydrauliques de moins de 6 tonnes."
                        ]
                    },
                    "lien": {
                        "type": "string",
                        "maxLength": 255,
                        "format": "uri",
                        "pattern": "^https://",
                        "description": "L’adresse de la fiche ou de l’inscription chez vous.",
                        "examples": [
                            "https://www.votre-organisme.fr/formations/caces-r482-b1"
                        ]
                    },
                    "organisme": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "L’organisme ; absent, le nom de votre page.",
                        "examples": [
                            "Centre de formation de la construction"
                        ]
                    },
                    "mode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "description": "presentiel, distanciel ou mixte.",
                        "examples": [
                            "presentiel"
                        ]
                    },
                    "lieu": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "La ville.",
                        "examples": [
                            "Blagnac"
                        ]
                    },
                    "code_postal": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^\\d{5}$",
                        "description": "Il range la formation dans son département.",
                        "examples": [
                            "31700"
                        ]
                    },
                    "duree_heures": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 99999,
                        "description": "La durée, en heures.",
                        "examples": [
                            21
                        ]
                    },
                    "debut": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "La date de la prochaine session.",
                        "examples": [
                            "2026-11-16"
                        ]
                    },
                    "pour_qui": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Le public visé.",
                        "examples": [
                            "Conducteurs d’engins débutants"
                        ]
                    },
                    "niveau_d_entree": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Le niveau demandé, en texte libre (voir aussi `niveau_entree`).",
                        "examples": [
                            "Sans niveau requis"
                        ]
                    },
                    "prerequis": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Les prérequis.",
                        "examples": [
                            "Avoir 18 ans"
                        ]
                    },
                    "objectifs": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Les objectifs de la formation.",
                        "examples": [
                            "Conduire une pelle de moins de 6 tonnes en sécurité"
                        ]
                    },
                    "infos_pratiques": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Prix, financement, horaires : ce qu’il faut savoir avant de s’inscrire.",
                        "examples": [
                            "1 200 € HT, finançable par votre OPCO"
                        ]
                    },
                    "metier": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "description": "Le métier visé, en texte.",
                        "examples": [
                            "Conducteur d’engins de chantier"
                        ]
                    },
                    "metier_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "pattern": "^[a-z0-9][a-z0-9\\-]{0,63}$",
                        "description": "Le code d’un métier du référentiel de Heyalink. Inconnu : refusé (422). Sans lui, Heyalink déduit le métier du code ROME, de `metier` ou de l’intitulé.",
                        "examples": [
                            "conducteur-d-engins-de-chantier"
                        ]
                    },
                    "famille_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 64,
                        "pattern": "^[a-z0-9][a-z0-9\\-]{0,63}$",
                        "description": "Le code d’une des 39 familles de métiers de Heyalink. Sans lui, la famille du métier.",
                        "examples": [
                            "terrassement-demolition"
                        ]
                    },
                    "code_rome": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^[A-N]\\d{4}$",
                        "description": "Le code ROME de France Travail (une lettre, quatre chiffres).",
                        "examples": [
                            "F1302"
                        ]
                    },
                    "financements": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "maxItems": 5,
                        "items": {
                            "type": "string",
                            "enum": [
                                "cpf",
                                "opco",
                                "france_travail",
                                "region",
                                "employeur"
                            ]
                        },
                        "uniqueItems": true,
                        "description": "Les financements possibles. « cpf » suppose un code RNCP ou RS (sinon un signalement `incoherence`).",
                        "examples": [
                            [
                                "cpf",
                                "opco"
                            ]
                        ]
                    },
                    "type_certification": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "diplome",
                            "habilitation",
                            "attestation",
                            null
                        ],
                        "description": "Ce que prépare la formation : diplome (diplôme ou titre), habilitation (habilitation, CACES ou certificat), attestation.",
                        "examples": [
                            "habilitation"
                        ]
                    },
                    "code_rncp": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^RNCP\\d{1,6}$",
                        "description": "Le code RNCP de la certification préparée (France Compétences), par exemple RNCP34567.",
                        "examples": [
                            "RNCP34567"
                        ]
                    },
                    "code_rs": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "pattern": "^RS\\d{1,6}$",
                        "description": "Le code RS (Répertoire spécifique, France Compétences), par exemple RS5080.",
                        "examples": [
                            "RS5080"
                        ]
                    },
                    "alternance": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "maxItems": 2,
                        "items": {
                            "type": "string",
                            "enum": [
                                "apprentissage",
                                "professionnalisation"
                            ]
                        },
                        "uniqueItems": true,
                        "description": "Le ou les contrats d’alternance.",
                        "examples": [
                            [
                                "apprentissage"
                            ]
                        ]
                    },
                    "niveau_entree": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "aucun",
                            "cap",
                            "bac",
                            "bac2",
                            "bac3",
                            "bac5",
                            "bac8",
                            null
                        ],
                        "description": "Le niveau demandé à l’entrée : aucun, cap, bac, bac2, bac3, bac5, bac8.",
                        "examples": [
                            "aucun"
                        ]
                    },
                    "prix": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "minimum": 0,
                        "maximum": 10000000,
                        "description": "Le prix total TTC par stagiaire, en euros. Toujours TTC : la fiche l’affiche ainsi, « 1 500 € TTC ».",
                        "examples": [
                            1440
                        ]
                    },
                    "certification": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "description": "L’intitulé de la certification préparée, par exemple « CAP Couvreur » ou « CACES® R482 catégorie B1 ». Avec `code_rncp` ou `code_rs`, la fiche montre la carte « Ce que vous obtenez » ; sans code, la certification est affichée comme déclarée par l’organisme (v1.8.0).",
                        "examples": [
                            "CACES® R482 catégorie B1"
                        ]
                    },
                    "diplome": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "description": "Le sigle du diplôme d’État préparé : CAP, BP, BTS, Bac pro, BUT… Il fait écrire « Diplôme national » sur la fiche (v1.8.0).",
                        "examples": [
                            "CAP"
                        ]
                    },
                    "niveau_certification": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "minimum": 1,
                        "maximum": 8,
                        "description": "Le niveau européen de la certification (1 à 8), seulement avec un `code_rncp`. Le niveau du répertoire national passe devant (v1.8.0).",
                        "examples": [
                            3
                        ]
                    },
                    "attestation": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Vrai si la formation se termine par une attestation de fin de formation ; affiché seulement s’il est vrai (v1.8.0).",
                        "examples": [
                            false
                        ]
                    },
                    "photo_url": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2048,
                        "format": "uri",
                        "pattern": "^https://",
                        "description": "L’adresse https d’une photo de la formation (vos ateliers, une session) : JPEG, PNG, GIF ou WebP, 5 Mo au plus, servie par une adresse publique. Heyalink la recopie et la remet au propre (2 000 px de large au plus). Illisible : refusée (422). Envoyée à null : la photo est retirée ; absente : la photo reste (v1.8.0). Elle passe ensuite par la vérification des images de Heyalink, comme une photo de profil : tant qu’elle est vérifiée, `photo` rend la précédente ; refusée, elle n’est jamais publiée (07/11/2026).",
                        "examples": [
                            "https://www.votre-organisme.fr/images/plateau-engins.jpg"
                        ]
                    },
                    "photo_base64": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 7000100,
                        "description": "La même photo, envoyée en base64 (avec ou sans en-tête `data:`), à la place de `photo_url` (v1.8.0).",
                        "examples": [
                            "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ…"
                        ]
                    }
                },
                "description": "Un champ hors de cette liste n’est jamais publié ni refusé : il est ignoré, et la réponse le signale (`signalements`, code `champ_ignore`)."
            },
            "OffrePubliee": {
                "type": "object",
                "required": [
                    "reference",
                    "titre",
                    "lieu",
                    "departement",
                    "metier",
                    "code_rome",
                    "type_contrat",
                    "date_expiration",
                    "source",
                    "adresse",
                    "publiee_le",
                    "modifiee_le",
                    "etat",
                    "attente"
                ],
                "properties": {
                    "reference": {
                        "type": "string"
                    },
                    "titre": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "lieu": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "departement": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "metier": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "code_rome": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "type_contrat": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "date_expiration": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "metier_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Le métier du référentiel de Heyalink (reçu, ou déduit : voir `champs_deduits`)."
                    },
                    "famille_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "La famille de métiers (39 codes stables)."
                    },
                    "secteur": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Le grand secteur, lu depuis la famille au moment de la réponse ; il peut changer si le regroupement des familles change."
                    },
                    "secteur_de_recherche": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "gros-oeuvre-structure",
                            "toiture-facade-menuiseries",
                            "plomberie-chauffage-electricite",
                            "amenagement-finitions",
                            "travaux-publics-paysage",
                            "architecture-etudes-diagnostic",
                            "energie-environnement",
                            "fabricants-negoce-materiel",
                            "immobilier-maitrise-ouvrage",
                            "formation-emploi-services",
                            null
                        ],
                        "description": "Le secteur sous lequel l’annonce se trouve dans les filtres de recherche de Heyalink (un des dix), lu depuis la famille au moment de la réponse (v1.7.0)."
                    },
                    "experience_mois": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "temps_de_travail": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "plein",
                            "partiel",
                            null
                        ]
                    },
                    "teletravail": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "non",
                            "partiel",
                            "total",
                            null
                        ]
                    },
                    "alternance": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "apprentissage",
                            "professionnalisation",
                            null
                        ]
                    },
                    "salaire_min": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "salaire_max": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "salaire_periode": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "heure",
                            "jour",
                            "semaine",
                            "mois",
                            "an",
                            null
                        ]
                    },
                    "champs_deduits": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Les champs remplis par l’algorithme de Heyalink faute de les avoir reçus : ce ne sont pas vos données. Envoyez-les pour en décider vous-même."
                    },
                    "source": {
                        "type": "string"
                    },
                    "adresse": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri",
                        "description": "Sa page sur Heyalink ; vide pour une annonce de test ou simulée neuve."
                    },
                    "publiee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "modifiee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "etat": {
                        "type": "string",
                        "enum": [
                            "en_ligne",
                            "en_attente",
                            "archivee",
                            "pourvue",
                            "expiree",
                            "supprimee",
                            "masquee_par_la_moderation",
                            "fermee",
                            "retiree"
                        ],
                        "description": "`en_attente` : enregistrée, mais hors ligne tant que le plafond de facture du Grand compte est atteint ou qu’une facture reste impayée (voir `attente`)."
                    },
                    "media": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/PieceDAnnonce"
                        },
                        "description": "Depuis la v1.12.0 : les photos (6 au plus) et les PDF (6 au plus) de l’annonce, dans l’ordre ; la première photo est son visuel. Une annonce importée n’en a pas."
                    },
                    "attente": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "description": "Pourquoi l’annonce attend, quand `etat` vaut `en_attente` ; null sinon.",
                        "properties": {
                            "motif": {
                                "type": "string",
                                "enum": [
                                    "plafond",
                                    "impaye"
                                ],
                                "description": "`plafond` : le plafond de facture du mois est atteint ; `impaye` : une facture reste impayée quatorze jours après son échéance."
                            },
                            "depuis": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date-time"
                            },
                            "parait_au_plus_tard_le": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Au plafond : le premier jour du mois suivant, ou plus tôt si le plafond est relevé. Sur un impayé : null, l’annonce paraît au paiement."
                            }
                        },
                        "required": [
                            "motif",
                            "depuis",
                            "parait_au_plus_tard_le"
                        ],
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "FormationPubliee": {
                "type": "object",
                "required": [
                    "reference",
                    "titre",
                    "organisme",
                    "mode",
                    "lieu",
                    "duree_heures",
                    "debut",
                    "source",
                    "adresse",
                    "publiee_le",
                    "modifiee_le",
                    "etat",
                    "attente"
                ],
                "properties": {
                    "reference": {
                        "type": "string"
                    },
                    "titre": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "organisme": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "mode": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "lieu": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "duree_heures": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "debut": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "metier_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Le métier visé, du référentiel de Heyalink (reçu, ou déduit : voir `champs_deduits`)."
                    },
                    "famille_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "secteur": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Le grand secteur, lu depuis la famille au moment de la réponse."
                    },
                    "secteur_de_recherche": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "gros-oeuvre-structure",
                            "toiture-facade-menuiseries",
                            "plomberie-chauffage-electricite",
                            "amenagement-finitions",
                            "travaux-publics-paysage",
                            "architecture-etudes-diagnostic",
                            "energie-environnement",
                            "fabricants-negoce-materiel",
                            "immobilier-maitrise-ouvrage",
                            "formation-emploi-services",
                            null
                        ],
                        "description": "Le secteur sous lequel l’annonce se trouve dans les filtres de recherche de Heyalink (un des dix), lu depuis la famille au moment de la réponse (v1.7.0)."
                    },
                    "code_rome": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "financements": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string",
                            "enum": [
                                "cpf",
                                "opco",
                                "france_travail",
                                "region",
                                "employeur"
                            ]
                        }
                    },
                    "type_certification": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "diplome",
                            "habilitation",
                            "attestation",
                            null
                        ]
                    },
                    "code_rncp": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "code_rs": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "alternance": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string",
                            "enum": [
                                "apprentissage",
                                "professionnalisation"
                            ]
                        }
                    },
                    "niveau_entree": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "aucun",
                            "cap",
                            "bac",
                            "bac2",
                            "bac3",
                            "bac5",
                            "bac8",
                            null
                        ]
                    },
                    "prix": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Le prix total TTC par stagiaire, en euros, tel que reçu ; la fiche l’affiche « 1 500 € TTC »."
                    },
                    "champs_deduits": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Les champs remplis par l’algorithme de Heyalink faute de les avoir reçus : ce ne sont pas vos données. Envoyez-les pour en décider vous-même."
                    },
                    "famille": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Le nom court de la famille de métier, calculé par Heyalink (le titre d’abord, puis `famille_code`), tel que la fiche l’écrit (« Formations › Électricité »), dans la langue de la requête (v1.8.0)."
                    },
                    "certification": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "La certification reçue (v1.8.0)."
                    },
                    "diplome": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Le sigle du diplôme reçu (v1.8.0)."
                    },
                    "niveau_certification": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Le niveau européen affiché (1 à 8) : celui du répertoire national, sinon celui reçu ; seulement pour un RNCP (v1.8.0)."
                    },
                    "attestation": {
                        "type": "boolean",
                        "description": "La formation se termine par une attestation (v1.8.0)."
                    },
                    "photo": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "L’adresse de la photo recopiée par Heyalink, ou null (v1.8.0)."
                    },
                    "source": {
                        "type": "string"
                    },
                    "adresse": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri",
                        "description": "Sa page sur Heyalink ; vide pour une annonce de test ou simulée neuve."
                    },
                    "publiee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "modifiee_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "etat": {
                        "type": "string",
                        "enum": [
                            "en_ligne",
                            "en_attente",
                            "archivee",
                            "pourvue",
                            "expiree",
                            "supprimee",
                            "masquee_par_la_moderation",
                            "fermee",
                            "retiree"
                        ],
                        "description": "`en_attente` : enregistrée, mais hors ligne tant que le plafond de facture du Grand compte est atteint ou qu’une facture reste impayée (voir `attente`)."
                    },
                    "media": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/PieceDAnnonce"
                        },
                        "description": "Depuis la v1.12.0 : les photos (6 au plus) et les PDF (6 au plus) de l’annonce, dans l’ordre ; la première photo est son visuel. Une annonce importée n’en a pas."
                    },
                    "attente": {
                        "type": [
                            "object",
                            "null"
                        ],
                        "description": "Pourquoi l’annonce attend, quand `etat` vaut `en_attente` ; null sinon.",
                        "properties": {
                            "motif": {
                                "type": "string",
                                "enum": [
                                    "plafond",
                                    "impaye"
                                ],
                                "description": "`plafond` : le plafond de facture du mois est atteint ; `impaye` : une facture reste impayée quatorze jours après son échéance."
                            },
                            "depuis": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date-time"
                            },
                            "parait_au_plus_tard_le": {
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "format": "date",
                                "description": "Au plafond : le premier jour du mois suivant, ou plus tôt si le plafond est relevé. Sur un impayé : null, l’annonce paraît au paiement."
                            }
                        },
                        "required": [
                            "motif",
                            "depuis",
                            "parait_au_plus_tard_le"
                        ],
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "PieceDAnnonce": {
                "type": "object",
                "description": "Depuis la v1.12.0. Une photo (JPEG, PNG, WebP, HEIC, 10 Mo) ou un PDF (20 Mo).",
                "required": [
                    "id",
                    "type",
                    "nom",
                    "url",
                    "taille",
                    "ordre",
                    "statut"
                ],
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "photo",
                            "document"
                        ]
                    },
                    "nom": {
                        "type": "string"
                    },
                    "url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "taille": {
                        "type": "integer",
                        "description": "En octets."
                    },
                    "ordre": {
                        "type": "integer"
                    },
                    "statut": {
                        "type": "string",
                        "enum": [
                            "verification",
                            "publiee",
                            "refusee"
                        ],
                        "description": "`verification` : la modération n’a pas répondu, aucun membre ne la voit encore ; `publiee` ; `refusee` : retenue par la modération (webhook `annonce.piece_refusee`)."
                    }
                },
                "additionalProperties": false
            },
            "Signalement": {
                "type": "object",
                "description": "Un signalement sur l’annonce reçue. Il ne bloque jamais la publication.",
                "required": [
                    "code",
                    "champ",
                    "message"
                ],
                "properties": {
                    "code": {
                        "type": "string",
                        "enum": [
                            "champ_ignore",
                            "champ_recommande_absent",
                            "valeur_deduite",
                            "incoherence"
                        ],
                        "description": "`champ_ignore` : un champ hors du contrat, ignoré (rien n’est refusé) ; `champ_recommande_absent` : un champ qui manque et sort l’annonce d’un filtre ; `valeur_deduite` : une valeur remplie par l’algorithme de Heyalink, faute de la recevoir (voir `origine`) ; `incoherence` : deux champs qui ne vont pas ensemble (CPF sans code RNCP ni RS)."
                    },
                    "champ": {
                        "type": "string"
                    },
                    "message": {
                        "type": "string"
                    },
                    "origine": {
                        "type": "string",
                        "enum": [
                            "code_rome",
                            "metier",
                            "titre",
                            "metier_code",
                            "code_naf",
                            "type_contrat",
                            "code_rncp",
                            "code_rs",
                            "formacode"
                        ],
                        "description": "Pour une valeur déduite : le champ d’où elle vient."
                    }
                },
                "additionalProperties": false
            },
            "BilanDeSource": {
                "type": "object",
                "required": [
                    "lues",
                    "creees",
                    "modifiees",
                    "restaurees",
                    "inchangees",
                    "doublons",
                    "archivees",
                    "erreurs",
                    "supprimees_sur_le_site"
                ],
                "properties": {
                    "lues": {
                        "type": "integer"
                    },
                    "creees": {
                        "type": "integer"
                    },
                    "modifiees": {
                        "type": "integer"
                    },
                    "restaurees": {
                        "type": "integer"
                    },
                    "inchangees": {
                        "type": "integer"
                    },
                    "doublons": {
                        "type": "integer"
                    },
                    "archivees": {
                        "type": "integer"
                    },
                    "erreurs": {
                        "type": "integer"
                    },
                    "supprimees_sur_le_site": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            },
            "Violation": {
                "type": "object",
                "required": [
                    "champ",
                    "regle",
                    "message",
                    "exemple"
                ],
                "properties": {
                    "champ": {
                        "type": "string"
                    },
                    "regle": {
                        "type": "string",
                        "description": "La règle qui a échoué : required, max, url, date_format…"
                    },
                    "message": {
                        "type": "string"
                    },
                    "exemple": {
                        "description": "Une valeur valide pour ce champ."
                    }
                },
                "additionalProperties": false
            },
            "Probleme": {
                "type": "object",
                "description": "RFC 9457",
                "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "instance"
                ],
                "properties": {
                    "type": {
                        "type": "string",
                        "format": "uri",
                        "description": "L’adresse de l’explication de cette erreur dans la documentation."
                    },
                    "title": {
                        "type": "string",
                        "description": "Le nom de l’erreur, en clair."
                    },
                    "status": {
                        "type": "integer",
                        "description": "Le code HTTP de la réponse."
                    },
                    "detail": {
                        "type": "string",
                        "description": "Ce qui ne va pas et quoi corriger, lisible tel quel."
                    },
                    "instance": {
                        "type": "string",
                        "description": "Le chemin de l’appel refusé."
                    },
                    "errors": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "description": "Les messages, champ par champ."
                    },
                    "violations": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Violation"
                        },
                        "description": "Pour chaque champ refusé : la règle qui a échoué, le message et une valeur valide."
                    }
                },
                "additionalProperties": false
            },
            "ErreurOAuth": {
                "type": "object",
                "required": [
                    "error"
                ],
                "properties": {
                    "error": {
                        "type": "string"
                    },
                    "error_description": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "Sante": {
                "type": "object",
                "required": [
                    "etat",
                    "api",
                    "version",
                    "base",
                    "duree_ms",
                    "horodatage"
                ],
                "properties": {
                    "etat": {
                        "type": "string",
                        "enum": [
                            "ok",
                            "degrade"
                        ]
                    },
                    "api": {
                        "type": "string"
                    },
                    "version": {
                        "type": "string"
                    },
                    "base": {
                        "type": "string"
                    },
                    "duree_ms": {
                        "type": "integer"
                    },
                    "horodatage": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "additionalProperties": false
            },
            "EvenementWebhook": {
                "type": "object",
                "required": [
                    "id",
                    "evenement",
                    "cree_le",
                    "bac_a_sable",
                    "donnees"
                ],
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "evenement": {
                        "type": "string",
                        "enum": [
                            "annonce.publiee",
                            "annonce.en_attente",
                            "annonce.refusee",
                            "annonce.expiree",
                            "annonce.archivee",
                            "annonce.pourvue",
                            "annonce.fermee",
                            "annonce.rouverte",
                            "annonce.supprimee",
                            "annonce.piece_refusee",
                            "sous_traitance.publiee",
                            "sous_traitance.fermee",
                            "sous_traitance.rouverte",
                            "sous_traitance.supprimee",
                            "sous_traitance.candidature_recue",
                            "ping"
                        ],
                        "description": "Depuis le 07/11/2026 (v1.10.0), `annonce.expiree` ne vise plus que les annonces reprises d’une source (flux, page carrières) que la source dit échues ; une annonce envoyée par l’API n’expire plus. Depuis la v1.11.0 : `annonce.fermee`, `annonce.rouverte` et `annonce.supprimee`, quand un gérant ferme, rouvre ou supprime l’annonce (sur Heyalink ou par l’API), et le geste de la page sur un de ses services (`donnees.nature` : `service`, `donnees.reference` : son identifiant) ; `annonce.publiee` aussi, à la publication d’un service. Depuis la v1.12.0 : `annonce.piece_refusee`, quand la modération refuse une photo ou un PDF de l’annonce ; `donnees.piece` porte `id`, `type` et `nom` de la pièce. Depuis la v1.13.0 (API Emploi) : `sous_traitance.publiee`, `.fermee`, `.rouverte`, `.supprimee` et `.candidature_recue`, pour les demandes de sous-traitance de la page, d’où qu’elles viennent ; `donnees` porte `nature` (`sous_traitance`), `demande`, `titre`, `adresse` et, pour une candidature, `candidature`."
                    },
                    "cree_le": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "bac_a_sable": {
                        "type": "boolean",
                        "description": "Vrai pour une adresse de test : l’événement vient d’une annonce de test."
                    },
                    "donnees": {
                        "type": "object"
                    }
                },
                "additionalProperties": false
            },
            "ServiceBlocParBloc": {
                "type": "object",
                "description": "Un service rempli bloc par bloc (v1.11.0).",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "etat": {
                        "type": "string",
                        "enum": [
                            "brouillon",
                            "en_ligne",
                            "ferme"
                        ]
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "prestation",
                            "bien",
                            "produit",
                            "reseau_evenement"
                        ]
                    },
                    "blocs": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "manquants": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "publiable": {
                        "type": "boolean"
                    },
                    "valeurs": {
                        "type": "object"
                    },
                    "affichage": {
                        "type": "object"
                    },
                    "photos": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        }
                    },
                    "documents": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        }
                    },
                    "adresse": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri"
                    },
                    "publie_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "ferme_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                }
            },
            "Domaine": {
                "type": "object",
                "required": [
                    "domaine",
                    "prouve",
                    "jeton",
                    "prouve_par",
                    "prouve_le"
                ],
                "properties": {
                    "domaine": {
                        "type": "string"
                    },
                    "prouve": {
                        "type": "boolean"
                    },
                    "jeton": {
                        "type": "string"
                    },
                    "prouve_par": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "meta",
                            "fichier",
                            null
                        ]
                    },
                    "prouve_le": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                },
                "additionalProperties": false
            }
        }
    }
}
