Automatisation

Runner & CI

Exécution dans l’app et en CLI, rapports JSON/JUnit, --bail, codes de sortie et GitHub Actions.

# Dans l’app

Le runner exécute toute la collection dans l’ordre des fichiers. Chaque requête suit le cycle preRequest → envoi → tests et enrichit le rapport visible dans le panneau runner. Les requêtes ws, sse et grpc sont sautées.

# CLI / CI

Commande complète

zapi --run \
  --collection ./api-tests \
  --env staging \
  --report reports/zapi.json \
  --junit reports/zapi.xml \
  --bail

Option	Rôle
`--run`	Active le mode CI sans fenêtre.
`--collection`	Dossier de collection (obligatoire).
`--env`	Environnement à utiliser, sinon le premier disponible.
`--report`	Écrit un rapport JSON détaillé.
`--junit`	Écrit un rapport JUnit XML.
`--bail`	Arrête au premier échec.

# Rapports & codes de sortie

Code	Signification
`0`	Toutes les requêtes et tous les tests ont réussi.
`1`	Au moins une requête ou un test a échoué.
`2`	Erreur de configuration ou exécution impossible.

.github/workflows/api.yml

name: api-contracts
on: [push, pull_request]

jobs:
  zapi:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: zapi --run --collection ./api-tests --env ci --junit reports/zapi.xml
      - uses: dorny/test-reporter@v1
        if: always()
        with:
          name: Zapi API tests
          path: reports/zapi.xml
          reporter: java-junit