QATrax
Ver en Markdown

Referencia de la API

Las rutas de automatización, su autenticación y sus respuestas.


Autenticación

Authorization: Bearer <clé de CI>. Una clave solo vale para su proyecto y sus operaciones; una clave ausente, no válida, revocada o caducada recibe 401; una ruta fuera de la automatización, 403. Las respuestas están en JSON.

Rutas

métodorutaoperaciónfunción
POST/importpousserimportar el plan Dev+Test (el proyecto se lee en el plan)
POST/runs?p=<projet>&format=jsonpousserresultados de pruebas (JUnit XML, NUnit, TRX, TestNG, Robot, CTest, Cucumber, Behave, Allure, CTRF, TAP o JSON; véase Formato de los resultados)
POST/sbom?p=<projet>&version=<v>[&motif=…]pousseruna SBOM CycloneDX o SPDX; una carga distinta se convierte en una revisión (respuesta: revision, nouvelleRevision); motivo opcional para la CI, «dépôt de la CI» por defecto — véase Corregir sin borrar
GET/livrable?p=<projet>pousserel estado del entregable
POST/livrable?p=<projet>&format=jsonemettreemitir un entregable sellado (version=)
GET/livrable/telecharger?no=<numéro>pousserel JSON sellado
GET/livrable/certificat?no=<numéro>pousserel certificado (&format=pdf: PDF firmado)

Rutas públicas

métodorutafunción
GET/livrable/verifier?no=<numéro>verificar un entregable registrado
POST/livrable/verifierverificar el documento que se tiene
GET/cle-publiquela clave pública del espacio
GET/api/healthel estado del servicio, y demarreLe: la hora de arranque de la instancia
GET/modeles/<fichier>las plantillas: resultats-modele.xml, .tap, .json, plan-modele.json
GET/verifierla página de verificación de un entregable, sin cuenta

Las acciones de corrección (anular una carga, modificar el plan, registrar una prueba manual) no están abiertas a las claves de CI (403): comprometen a una persona, que inicia sesión.

Códigos

200 éxito · 400 petición incompleta · 401 clave rechazada · 403 fuera del alcance de la clave (o espacio en solo lectura) · 409 verificación negativa · 413 cuerpo demasiado grande · 422 plan o documento no válido · 503 servicio no configurado (la respuesta indica qué hay que configurar).