# OpenAPI

> La spécification OpenAPI 3.1 complète de l’API, vérifiée contre les vraies réponses.

Documentation de l’API de WoWDB des Défias : https://docs.wowdb.assemblee-defias.fr/openapi

## Spécification OpenAPI 3.1

Toute l’API est décrite en OpenAPI 3.1 : chaque route, chaque paramètre avec ses valeurs permises, chaque objet et chaque champ, les erreurs et les en-têtes. La spécification est générée depuis la même source que cette documentation, et un test la confronte aux vraies réponses : chaque route documentée existe, chaque champ documenté est présent.

- Adresse : [https://api.wowdb.assemblee-defias.fr/v1/openapi.json](https://api.wowdb.assemblee-defias.fr/v1/openapi.json)
- Importez-la dans Postman, Insomnia, Bruno, Hoppscotch ou Swagger UI pour essayer l’API sans écrire de code.
- Générez un client typé : [générateurs](https://docs.wowdb.assemblee-defias.fr/bibliotheques#openapi-generator).
- Donnez-la à un assistant IA pour qu’il écrive du code juste du premier coup.

**Télécharger**

```bash
curl -o wowdb-openapi.json https://api.wowdb.assemblee-defias.fr/v1/openapi.json
```

## Obtenir la spécification OpenAPI

`GET /v1/openapi.json`

La spécification OpenAPI 3.1 complète de l’API, en JSON.

**Paramètres**

Aucun paramètre.

**Renvoie** : Le document OpenAPI 3.1 (JSON).

---

API de WoWDB des Défias, v1 (2026-10-01). Adresse de base : https://api.wowdb.assemblee-defias.fr/v1. Index : https://docs.wowdb.assemblee-defias.fr/llms.txt.
