Skip to main content

Collections API

Toutes les collections couvrent les 172 endpoints de l’API, groupés par module. Maintenues automatiquement à partir de openapi.json.

Téléchargements

Variables d’environnement

Les collections utilisent ces variables — à configurer dans votre outil :

Flow d’utilisation

1. Postman

Import

Ou via l’UI

  1. File → Import → Upload Files
  2. Sélectionner thehive-api.postman.json
  3. Créer un environnement avec les variables ci-dessus
  4. Lancer Auth / login → tokens stockés automatiquement

Script de test auto (login)

Au niveau de la collection, dans Tests :

2. Insomnia

Variables dans Environment (JSON) :

3. Bruno

Bruno stocke les collections comme des fichiers .bru en markdown — versionnable avec git.

Structure

Exemple login.bru

4. Régénération

Les collections sont générées depuis api-reference/openapi.json. Pour régénérer localement :

5. Exemples d’appels pré-configurés

Toutes les requêtes incluent :
  • Headers : Authorization: Bearer {{access_token}}, Content-Type: application/json
  • Exemples de body avec valeurs fictives cohérentes
  • Paramètres de chemin pré-remplis (:id = 1)
  • Tests automatiques de base (status 2xx, schéma JSON)

6. Workflow CI

Les collections sont régénérées automatiquement à chaque modification du backend Spring Boot (trigger GitLab CI docs:regenerate-collections).

Voir aussi