Clearaccess publie une petite surface de découverte publique destinée aux agents, intégrateurs et outils opérationnels.
Points de terminaison publics
| Point de terminaison | Fonction |
|---|---|
/api/health |
Vérification de l’état et de la disponibilité de l’application publique |
/.well-known/api-catalog |
Catalogue de découverte d’API lisible par machine |
/.well-known/agent-skills/index.json |
Index de découverte des compétences d’agent |
/.well-known/openid-configuration |
Métadonnées OIDC pour la découverte de l’authentification des agents |
/.well-known/oauth-authorization-server |
Métadonnées du serveur d’autorisation OAuth |
/.well-known/oauth-protected-resource |
Métadonnées de la ressource protégée OAuth pour /api |
/.well-known/mcp/server-card.json |
Fiche serveur MCP pour la découverte par les agents |
/docs/api |
Présentation destinée aux humains de la surface API publique |
Surface d’authentification
Clearaccess fournit des routes d’authentification orientées navigateur sous /api/auth/* avec Better Auth.
- Ces routes prennent en charge les parcours d’authentification par session déjà utilisés par le produit.
- Les métadonnées de découverte OAuth/OIDC sont publiées pour les agents qui doivent identifier la surface d’authentification actuelle.
- Les métadonnées des API protégées annoncent l’identifiant de la ressource API, le serveur d’autorisation, la méthode par jeton Bearer et les portées de jetons API prises en charge.
- Après connexion, les jetons API personnels peuvent être créés depuis
/dashboard/account/api-tokens.
Réponses lisibles par les agents
Les pages HTML publiques peuvent être fournies en Markdown si la requête contient :
Accept: text/markdown
Sur les pages publiques compatibles, cet en-tête entraîne une réponse Markdown avec Content-Type: text/markdown.
Éléments annoncés dans le catalogue API
Le catalogue référence actuellement les ressources stables et utiles au public :
- la documentation de l’API publique ;
- le point de terminaison de santé de l’application ;
- les métadonnées de découverte des compétences d’agent ;
- les métadonnées de la ressource protégée OAuth ;
- les métadonnées de la fiche serveur MCP.
Le catalogue ne prétend pas fournir de document OpenAPI à cette étape, car cette ressource n’a pas encore été publiée officiellement.