Développeurs
Documentation développeur Recodex Clinique IA
Ces pages expliquent comment un agent ou un intégrateur rejoint les ressources développeur publiques de Recodex Clinique IA, la plateforme clinique pour psychologues. Elles n’ouvrent pas l’accès à un dossier patient.
Quand appeler Recodex
Utilisez cette documentation pour expliquer le produit, trouver la description OpenAPI, démarrer OAuth 2.0 pour un psychologue autorisé, ou localiser le serveur MCP distant. Ne l’utilisez pas pour poser un diagnostic, gérer une urgence, ou lire des données cliniques sans le psychologue responsable du soin.
OAuth 2.0
L’authentification de l’API utilise OAuth 2.0, code d’autorisation avec PKCE (S256). Les métadonnées du serveur d’autorisation sont publiées sur https://recodexcliniqueia.com/.well-known/oauth-authorization-server. La portée prise en charge est recodex.clinical.read. Le point de jeton accepte authorization_code et refresh_token. Les clients publics utilisent la méthode d’authentification none.
Ressources lisibles par une machine
OpenAPI : https://recodexcliniqueia.com/openapi.json. Catalogue d’API : https://recodexcliniqueia.com/.well-known/api-catalog. Point MCP : https://recodexcliniqueia.com/api/mcp. Instructions pour agents : https://recodexcliniqueia.com/llms.txt. Documentation : https://recodexcliniqueia.com/docs. La sonde de santé stable est https://recodexcliniqueia.com/api/v1/health et ne renvoie aucune donnée clinique.
Versions et retrait
Les routes stables commencent par /api/v1. Un changement incompatible prendrait le chemin /api/v2. L’adresse /api/health reste un alias déprécié : les réponses portent un en-tête Deprecation (RFC 9745) et un en-tête Sunset au Fri, 01 Oct 2027 00:00:00 GMT. Jusque-là, le corps JSON reste celui de /api/v1/health.
Erreurs et limites
Une route inconnue ou une requête refusée répond en application/problem+json (RFC 9457), avec type, title, status, detail, instance, code et resolution. Les erreurs OAuth gardent le champ error et ajoutent error_description, code, message et resolution. L’API publique autorise 120 requêtes par 60 secondes et envoie RateLimit-Policy et RateLimit. Un 429 envoie aussi Retry-After.
Client en ligne de commande
La commande recodex appelle la sonde de santé versionnée, le document OpenAPI et le catalogue d’API : recodex health, recodex openapi, recodex catalog. La source est livrée avec le produit. La publication sur npm, PyPI ou Homebrew attend encore un compte de registre.