Aller au contenu

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.

RéférenceAdministrateurDéveloppeurPartenaire
Voir en Markdown

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 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 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 : format, validation, pagination, idempotence, limites de débit ;
  • Codes d'erreur : chaque statut HTTP et les messages fréquents, cités à l'identique ;
  • Limites et quotas : toutes les valeurs par défaut et tous les plafonds ;
  • 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.

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 adresseNouvelle section
/v1.0/dev/02-discoveryAuthentification
/v1.0/dev/10-api-conventionsRéférence API
/v1.0/dev/15-errors-httpCodes d'erreur
/v1.0/dev/20-mcp-server-overviewOutils pour assistants IA
/v1.0/user/06-usersUtilisateurs et équipes
/v1.0/user/10-api-keysClés API

Une ancienne page qui n'a pas d'équivalent direct mène à Démarrer. 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.