API HTTP (OpenAPI)

Chaque service de domaine publiera le document OpenAPI de sa surface HTTP dans son jar *-api (META-INF/openapi/), et cette page le rendra — opérations, paramètres, schémas de requête et de réponse — avec Fumadocs OpenAPI : la documentation d'un contrat est le contrat lui-même.

Ce que toutes les API partagent déjàCopy Anchor Link

• Les erreurs sont du application/problem+json avec un code stable et le requestId — voir Web et Problem Details.
• L'authentification est un jeton de session bearer vérifié en local ; /internal/v1/** prend un jeton SERVICE — voir Sécurité.
• Les listes paginent par clé avec un cursor opaque et renvoient nextCursor jusqu'à la dernière page.