{
  "openapi": "3.1.0",
  "info": {
    "title": "API VerifierMonDevis",
    "version": "1.0.0",
    "description": "Analyse de devis de travaux : entreprise vérifiée aux registres, clauses, risques, et prix quand ils sont comparables. Une analyse prend en général 1 à 3 minutes. Chaque analyse prête consomme un crédit ; un document refusé le rend (5 par 24 h au plus), une analyse en échec aussi (20 par 24 h au plus). Débit : 10 envois par minute, refusés compris, et 5 analyses en cours par compte."
  },
  "servers": [
    {
      "url": "https://www.verifiermondevis.fr/api/v1"
    }
  ],
  "security": [
    {
      "cle": []
    }
  ],
  "components": {
    "securitySchemes": {
      "cle": {
        "type": "http",
        "scheme": "bearer",
        "description": "Votre clé, au format vmd_…"
      }
    },
    "schemas": {
      "Analyse": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
          },
          "objet": {
            "type": "string",
            "const": "analyse"
          },
          "contrat": {
            "type": "string",
            "const": "v1"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "processing",
              "ready",
              "rejected",
              "failed"
            ],
            "description": "queued, processing, puis ready, rejected (facture ou document hors sujet) ou failed."
          },
          "external_ref": {
            "description": "Votre référence, telle qu'envoyée.",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": "string",
            "description": "ISO 8601."
          },
          "completed_at": {
            "description": "ISO 8601, quand l'analyse est prête, refusée ou en échec.",
            "type": [
              "string",
              "null"
            ]
          },
          "engine_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "document": {
            "type": "object",
            "properties": {
              "nom_fichier": {
                "type": "string"
              }
            },
            "required": [
              "nom_fichier"
            ],
            "additionalProperties": false
          },
          "montants": {
            "type": "object",
            "properties": {
              "total_ht": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "total_ttc": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "ecart_estime": {
                "description": "Écart HT en euros, rattaché à des postes nommés. null s'il n'y en a pas, ou tant qu'un expert n'a pas tranché.",
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "total_ht",
              "total_ttc",
              "ecart_estime"
            ],
            "additionalProperties": false
          },
          "verdict": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "decision": {
                    "type": "string",
                    "enum": [
                      "signer",
                      "negocier",
                      "ne_pas_signer"
                    ]
                  },
                  "niveau": {
                    "type": "string",
                    "enum": [
                      "vert",
                      "orange",
                      "rouge"
                    ]
                  },
                  "titre": {
                    "type": "string"
                  },
                  "motif": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "motifs_bloquants": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "decision",
                  "niveau",
                  "titre",
                  "motif",
                  "motifs_bloquants"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "entreprise": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "nom": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "siret": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "identifiee": {
                    "type": "boolean",
                    "description": "Retrouvée au registre des entreprises."
                  },
                  "radiee": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "procedure_collective": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "anciennete_annees": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "rge": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  }
                },
                "required": [
                  "nom",
                  "siret",
                  "identifiee",
                  "radiee",
                  "procedure_collective",
                  "anciennete_annees",
                  "rge"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "verifie": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "texte": {
                  "type": "string"
                },
                "ton": {
                  "type": "string",
                  "enum": [
                    "vert",
                    "gris"
                  ]
                }
              },
              "required": [
                "texte",
                "ton"
              ],
              "additionalProperties": false
            },
            "description": "Ce que nous avons vérifié."
          },
          "a_verifier": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Ce que le client doit vérifier avant de signer."
          },
          "leviers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "objectif": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "negocier",
                        "securiser"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "niveau": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "puissant",
                        "important",
                        "bonus"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "titre": {
                  "type": "string"
                },
                "detail": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "type",
                "objectif",
                "niveau",
                "titre",
                "detail"
              ],
              "additionalProperties": false
            }
          },
          "message_artisan": {
            "description": "Un message prêt à envoyer à l'artisan.",
            "type": [
              "string",
              "null"
            ]
          },
          "revue": {
            "type": "object",
            "properties": {
              "statut": {
                "type": "string",
                "enum": [
                  "automatique",
                  "en_revue",
                  "validee",
                  "corrigee"
                ]
              },
              "relue_le": {
                "description": "ISO 8601, quand un expert a terminé la relecture. null sinon.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "message_expert": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "explication": {
                "description": "Ce qui reste à venir pour cette analyse, en une phrase à lire ou à afficher. null tant que le statut ne vaut pas ready.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "statut",
              "relue_le",
              "message_expert",
              "explication"
            ],
            "additionalProperties": false
          },
          "limites": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "prix_verifies": {
                    "type": "boolean",
                    "description": "Plus de la moitié du montant a été comparée à nos références."
                  },
                  "cas_particulier": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "devis_etranger",
                          "estimation_courtier",
                          "devis_incomplet",
                          "hors_perimetre",
                          "prestation_intellectuelle"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "prix_verifies",
                  "cas_particulier"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "refus": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "motif": {
                    "type": "string"
                  }
                },
                "required": [
                  "motif"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "type": "string",
            "description": "La page de l'analyse, pour le titulaire du compte."
          }
        },
        "required": [
          "id",
          "objet",
          "contrat",
          "status",
          "external_ref",
          "created_at",
          "completed_at",
          "engine_version",
          "document",
          "montants",
          "verdict",
          "entreprise",
          "verifie",
          "a_verifier",
          "leviers",
          "message_artisan",
          "revue",
          "limites",
          "refus",
          "url"
        ],
        "additionalProperties": false,
        "description": "Une analyse de devis."
      },
      "EvenementWebhook": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "analysis.ready",
              "analysis.rejected",
              "analysis.failed",
              "analysis.updated"
            ]
          },
          "created_at": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued",
                  "processing",
                  "ready",
                  "rejected",
                  "failed"
                ]
              },
              "external_ref": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "status",
              "external_ref"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "type",
          "created_at",
          "data"
        ],
        "additionalProperties": false,
        "description": "Envoyé en POST à votre webhook_url, signé au format Standard Webhooks (en-têtes webhook-id, webhook-timestamp, webhook-signature)."
      },
      "Erreur": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "type",
              "message"
            ],
            "additionalProperties": {}
          }
        },
        "required": [
          "error"
        ],
        "additionalProperties": false
      }
    }
  },
  "paths": {
    "/analyses": {
      "post": {
        "summary": "Déposer un devis",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "description": "Rejouer la même clé rend l'analyse déjà créée, sans nouveau débit. Si elle est en échec, refusée ou effacée, un nouvel envoi est créé."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "PDF, JPEG ou PNG, 4 Mo au plus, 15 pages au plus."
                  },
                  "external_ref": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "webhook_url": {
                    "type": "string",
                    "format": "uri",
                    "description": "HTTPS, nom de domaine public."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Même Idempotency-Key, ou même fichier déjà prêt ou en cours : l'analyse existante, sans débit.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "queued",
                        "processing",
                        "ready",
                        "rejected",
                        "failed"
                      ]
                    },
                    "existante": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "status"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "202": {
            "description": "Analyse créée. L'en-tête VMD-Credits-Restants donne le solde.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "queued",
                        "processing",
                        "ready",
                        "rejected",
                        "failed"
                      ]
                    },
                    "existante": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "status"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Corps illisible : multipart/form-data attendu, avec un champ « file ».",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "401": {
            "description": "Clé absente, invalide ou révoquée.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "402": {
            "description": "Crédits épuisés : aucune analyse n'est créée. `error.achat_url` mène à la page d'achat de crédits.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "403": {
            "description": "Compte suspendu.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "409": {
            "description": "Une requête avec la même Idempotency-Key est en cours.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "413": {
            "description": "Fichier de plus de 4 Mo.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "415": {
            "description": "Format non accepté.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "422": {
            "description": "Requête invalide : champ manquant ou mal formé, PDF trop long. Un PDF qui contient plusieurs devis est refusé avec `error.type` « plusieurs_devis » et `error.devis` (pages de début et de fin de chaque devis, numéro s'il est lu) : envoyez-les un par un. Aucune analyse n'est créée, aucun crédit n'est consommé.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "429": {
            "description": "Débit dépassé (en-tête Retry-After).",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Erreur interne.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          }
        }
      },
      "get": {
        "summary": "Lister les analyses du compte",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Le next_cursor de la page précédente, tel quel."
          },
          {
            "name": "en_revue",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "true"
              ]
            },
            "description": "true : seulement les analyses prêtes dont la relecture par un expert n'est pas terminée. Pour suivre les relectures sans webhook."
          }
        ],
        "responses": {
          "200": {
            "description": "Une page.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "queued",
                              "processing",
                              "ready",
                              "rejected",
                              "failed"
                            ]
                          },
                          "external_ref": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "created_at": {
                            "type": "string"
                          },
                          "completed_at": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "revue": {
                            "type": "object",
                            "properties": {
                              "statut": {
                                "type": "string",
                                "enum": [
                                  "automatique",
                                  "en_revue",
                                  "validee",
                                  "corrigee"
                                ]
                              }
                            },
                            "required": [
                              "statut"
                            ],
                            "additionalProperties": false
                          },
                          "url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "status",
                          "external_ref",
                          "created_at",
                          "completed_at",
                          "revue",
                          "url"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "data",
                    "next_cursor"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "401": {
            "description": "Clé absente, invalide ou révoquée.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "422": {
            "description": "cursor illisible, ou en_revue autre que true.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Erreur interne.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/analyses/{id}": {
      "get": {
        "summary": "Lire une analyse",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "L'analyse. Le verdict n'est présent que si status vaut ready.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Analyse"
                }
              }
            }
          },
          "401": {
            "description": "Clé absente, invalide ou révoquée.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Analyse introuvable.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Erreur interne.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Effacer une analyse et son document",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Effacée."
          },
          "401": {
            "description": "Clé absente, invalide ou révoquée.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Analyse introuvable.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "409": {
            "description": "Analyse en cours.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Erreur interne.",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "message"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    }
  },
  "webhooks": {
    "analysis.ready": {
      "post": {
        "summary": "analysis.ready",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EvenementWebhook"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx acquitte l'événement ; sinon 6 essais, de 1 min à 12 h."
          }
        }
      }
    },
    "analysis.rejected": {
      "post": {
        "summary": "analysis.rejected",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EvenementWebhook"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx acquitte l'événement ; sinon 6 essais, de 1 min à 12 h."
          }
        }
      }
    },
    "analysis.failed": {
      "post": {
        "summary": "analysis.failed",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EvenementWebhook"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx acquitte l'événement ; sinon 6 essais, de 1 min à 12 h."
          }
        }
      }
    },
    "analysis.updated": {
      "post": {
        "summary": "analysis.updated",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EvenementWebhook"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Toute réponse 2xx acquitte l'événement ; sinon 6 essais, de 1 min à 12 h."
          }
        }
      }
    }
  }
}