# Référence API

> Les routes d’automatisation, leur authentification et leurs réponses.


## Authentification

`Authorization: Bearer <clé de CI>`. Une clé ne vaut que pour son projet et ses opérations ; une clé absente,
invalide, révoquée ou expirée reçoit `401` ; une route hors automatisation, `403`. Les réponses sont en JSON.

## Routes

| méthode | chemin | opération | rôle |
|---|---|---|---|
| `POST` | `/import` | pousser | importer le plan Dev+Test (le projet se lit dans le plan) |
| `POST` | `/runs?p=<projet>&format=json` | pousser | des résultats d’essais (JUnit XML, NUnit, TRX, TestNG, Robot, CTest, Cucumber, Behave, Allure, CTRF, TAP ou JSON ; voir [Format des résultats](/docs/resultats)) |
| `POST` | `/sbom?p=<projet>&version=<v>[&motif=…]` | pousser | une SBOM CycloneDX ou SPDX ; un dépôt différent devient une **révision** (réponse : `revision`, `nouvelleRevision`) ; motif facultatif pour la CI, « dépôt de la CI » par défaut — voir [Corriger sans effacer](/docs/corriger) |
| `GET` | `/livrable?p=<projet>` | pousser | l’état du livrable |
| `POST` | `/livrable?p=<projet>&format=json` | emettre | émettre un livrable scellé (`version=`) |
| `GET` | `/livrable/telecharger?no=<numéro>` | pousser | le JSON scellé |
| `GET` | `/livrable/certificat?no=<numéro>` | pousser | le certificat (`&format=pdf` : PDF signé) |

## Routes publiques

| méthode | chemin | rôle |
|---|---|---|
| `GET` | `/livrable/verifier?no=<numéro>` | vérifier un livrable enregistré |
| `POST` | `/livrable/verifier` | vérifier la pièce qu’on détient |
| `GET` | `/cle-publique` | la clé publique de l’espace |
| `GET` | `/api/health` | l’état du service, et `demarreLe` : l’heure de démarrage de l’instance |
| `GET` | `/modeles/<fichier>` | les modèles : `resultats-modele.xml`, `.tap`, `.json`, `plan-modele.json` |
| `GET` | `/verifier` | la page de vérification d’un livrable, sans compte |

Les gestes de correction (annuler un dépôt, modifier le plan, saisir un essai manuel) ne sont **pas** ouverts aux
clés de CI (`403`) : ils engagent une personne, qui se connecte.

## Codes

`200` succès · `400` requête incomplète · `401` clé refusée · `403` hors de portée de la clé (ou espace en
lecture seule) · `409` vérification négative · `413` corps trop gros · `422` plan ou pièce invalide · `503`
service non configuré (la réponse dit quoi poser).
