# Brancher sa CI

> Créer une clé de CI, puis pousser plan, résultats d’essais et SBOM à chaque construction.


## La clé de CI

Dans votre espace : **Projets → Clés de CI**. Une clé ne vaut que pour **son projet** et pour les opérations
choisies (`pousser`, `emettre`). Elle se transmet dans l’en-tête `Authorization: Bearer <clé>`. Elle n’est
montrée qu’**une fois** ; rangez-la dans les secrets de votre CI. Révocable à tout moment.

## Ce que la CI pousse

| quoi | requête | corps |
|---|---|---|
| le plan Dev+Test (exigences, réalisations, tests) | `POST /import` | JSON du plan |
| les résultats d’essais | `POST /runs?p=<projet>&format=json` | le rapport de l’outil, tel quel : JUnit XML, NUnit, TRX, TestNG, Robot, CTest, Cucumber, Behave, Allure, CTRF, TAP ou JSON — voir [Format des résultats](/docs/resultats) |
| la SBOM | `POST /sbom?p=<projet>&version=<version du produit>` | CycloneDX ou SPDX (JSON) |

Voir les [recettes](/docs/recettes) pour GitHub Actions et GitLab CI, et la [référence API](/docs/api).

## Ce que QATrax refuse

Une SBOM sans version de produit, un fichier qui n’en est pas une, un projet que la clé ne couvre pas : la
réponse dit pourquoi, en JSON. Accepter « pour rendre service » produirait un dossier qui paraît conforme et ne
l’est pas.
