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) |
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 |
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).