# Nouvelle documentation

> 23 octobre 2026 — la documentation Wakastart est entièrement réorganisée par produit, avec une référence API complète et des outils pour assistants IA.

**23 octobre 2026.** La documentation de Wakastart a été réécrite. Elle ne sépare plus un espace « Utilisateur » et un espace « Développeur » : elle s'organise par produit, et chaque page indique à qui elle s'adresse.

## Ce qui change pour vous

### Un catalogue par produit

L'accueil présente les produits de Wakastart par famille : **Identité et accès**, **Hébergement**, **Personnalisation**, **Modules** et **Ressources**. Chaque produit a sa propre section, avec la même progression : une vue d'ensemble, les concepts, les guides, une liste de contrôle avant la mise en production pour les produits critiques, une référence et une page de dépannage.

Des badges en tête de page indiquent le public visé : administrateur, développeur ou partenaire.

### Des concepts expliqués

La section [Concepts](/v1.0/concepts) décrit le modèle de la plateforme : organisation multi-tenant, applications, environnements, définitions et instances, cycle de vie des ressources, niveaux d'administration, droits et profils, jeton enrichi et Discovery.

### Des guides console et API

Chaque guide suit les mêmes étapes : contexte, prérequis, étapes numérotées, vérification du résultat. Quand une opération existe à la fois dans la console et dans l'API publique, le guide présente les deux en onglets ; votre choix est mémorisé d'une page à l'autre. Les libellés de la console sont cités tels qu'ils apparaissent à l'écran.

### Une référence API complète

La [Référence API](/v1.0/reference-api) est rédigée à partir du code de la plateforme. Pour chaque endpoint de l'API publique et de Discovery : l'accès requis, les paramètres, un exemple cURL, la réponse attendue et les erreurs. Elle est complétée par :

- [Conventions de l'API](/v1.0/reference-api/conventions) : format, validation, pagination, idempotence, limites de débit ;
- [Codes d'erreur](/v1.0/codes-d-erreur) : chaque statut HTTP et les messages fréquents, cités à l'identique ;
- [Limites et quotas](/v1.0/limites) : toutes les valeurs par défaut et tous les plafonds ;
- [Glossaire](/v1.0/glossaire) : chaque terme de la documentation et de la console.

### Des outils pour assistants IA

Chaque page existe en Markdown (ajoutez `.md` à son URL), l'ensemble est indexé dans `llms.txt` et regroupé dans `llms-full.txt`, et un serveur MCP permet à votre assistant de chercher dans la documentation. Voir [Outils pour assistants IA](/v1.0/outils-ia).

### Vos anciens liens restent valables

Les anciennes adresses `/v1.0/user/…` et `/v1.0/dev/…` redirigent de façon permanente vers la section qui reprend leur contenu. Par exemple :

| Ancienne adresse | Nouvelle section |
|---|---|
| `/v1.0/dev/02-discovery` | [Authentification](/v1.0/authentification) |
| `/v1.0/dev/10-api-conventions` | [Référence API](/v1.0/reference-api) |
| `/v1.0/dev/15-errors-http` | [Codes d'erreur](/v1.0/codes-d-erreur) |
| `/v1.0/dev/20-mcp-server-overview` | [Outils pour assistants IA](/v1.0/outils-ia) |
| `/v1.0/user/06-users` | [Utilisateurs et équipes](/v1.0/utilisateurs) |
| `/v1.0/user/10-api-keys` | [Clés API](/v1.0/cles-api) |

Une ancienne page qui n'a pas d'équivalent direct mène à [Démarrer](/v1.0/demarrer). Mettez à jour vos favoris et les liens de votre propre documentation à l'occasion.

## Ce qui ne change pas

- Les URL de l'API publique, de Discovery et de la console sont inchangées.
- Le comportement de la plateforme est inchangé : cette note concerne la documentation.
