QATrax
Voir en Markdown

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éthodecheminopérationrôle
POST/importpousserimporter le plan Dev+Test (le projet se lit dans le plan)
POST/runs?p=<projet>&format=jsonpousserdes 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=…]pousserune 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>pousserl’état du livrable
POST/livrable?p=<projet>&format=jsonemettreémettre un livrable scellé (version=)
GET/livrable/telecharger?no=<numéro>pousserle JSON scellé
GET/livrable/certificat?no=<numéro>pousserle certificat (&format=pdf : PDF signé)

Routes publiques

méthodecheminrôle
GET/livrable/verifier?no=<numéro>vérifier un livrable enregistré
POST/livrable/verifiervérifier la pièce qu’on détient
GET/cle-publiquela clé publique de l’espace
GET/api/healthl’é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/verifierla 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).