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étodo | ruta | operación | función |
|---|---|---|---|
POST | /import | pousser | importar el plan Dev+Test (el proyecto se lee en el plan) |
POST | /runs?p=<projet>&format=json | pousser | resultados 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=…] | pousser | una 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> | pousser | el estado del entregable |
POST | /livrable?p=<projet>&format=json | emettre | emitir un entregable sellado (version=) |
GET | /livrable/telecharger?no=<numéro> | pousser | el JSON sellado |
GET | /livrable/certificat?no=<numéro> | pousser | el certificado (&format=pdf: PDF firmado) |
Rutas públicas
| método | ruta | función |
|---|---|---|
GET | /livrable/verifier?no=<numéro> | verificar un entregable registrado |
POST | /livrable/verifier | verificar el documento que se tiene |
GET | /cle-publique | la clave pública del espacio |
GET | /api/health | el 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 | /verifier | la 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).