Démarrer

Concepts

Collections, environnements, ordre d’exécution et conventions Git qui rendent les diffs lisibles.

# Une collection est un dossier

Une collection est un dossier ordinaire : un fichier collection.yml, un dossier environments/ et un dossier requests/ où chaque requête est un fichier .yml. Tu peux le committer, le reviewer en pull request et le partager.

Arborescence recommandée

ma-collection/
├─ collection.yml
├─ environments/
│  ├─ local.env.yml
│  └─ staging.env.yml
└─ requests/
   ├─ 01-login.yml
   ├─ 02-get-user.yml
   └─ 03-live-events.yml

# Environnements

Le nom d’un environnement vient du fichier : staging.env.yml devient staging. Chaque collection garde son propre environnement actif.

environments/staging.env.yml

variables:
  baseUrl: https://staging.api.acme.test
  email: [email protected]
  tenantId: acme-staging

# Ordre d’exécution

Le runner trie les fichiers par nom. Préfixe les requêtes critiques avec 01-, 02-… pour décrire un scénario explicite (login, création, vérification, nettoyage).