API ecentic : authentification.
La découverte publique ne nécessite aucun identifiant. Tout ce qui lit ou modifie un compte marchand nécessite une clé bearer que vous générez vous-même — sans appel commercial ni provisionnement manuel.
Clés en libre-service · Jetons bearer · Métadonnées OAuth
Choisir un chemin de requête
Explorez d’abord l’API. Ajoutez une clé Bearer lorsque votre client agit sur un compte marchand.
Votre client
Aucun identifiant requis
Découverte + sandbox
Ce qui ne nécessite aucune clé
La découverte est ouverte, volontairement.
Chaque point d’accès sous /api/v1 répond sans en-tête Authorization, tout comme les documents de découverte à emplacement connu, le document OpenAPI et l’outil MCP list_plans. Un agent peut découvrir toute la structure de l’API — points d’accès, offres, protocoles, compétences, limites de débit, codes d’erreur — avant même qu’un compte soit créé.
Le bac à sable est également ouvert : POST /api/v1/sandbox/simulation renvoie exactement le même format de réponse qu’une vraie simulation, calculé à partir d’une notation synthétique, afin qu’un client puisse être développé et testé sans aucun identifiant.
Votre client
Clé Bearer requise
REST + MCP
Envoyer une clé
Un seul en-tête, partout.
Envoyez la clé comme jeton bearer sur chaque requête protégée. Le même en-tête fonctionne sur la surface REST et sur les appels d’outils MCP.
Ne placez pas la clé dans une chaîne de requête : les chaînes de requête se retrouvent dans les journaux, les proxys et les en-têtes de référent, et ecentic ne la lira pas depuis cet emplacement.
Générer une clé
Deux parcours en libre-service, tous deux sous votre contrôle.
- Créer un compte
- Générer une clé
- L’enregistrer une fois
Créez un compte, puis générez une clé depuis le tableau de bord ou en appelant l’outil MCP create_api_key via une session authentifiée. Les clés ressemblent à ecentic_sk_…, ont une longue durée de vie et ne sont affichées qu’une seule fois — ecentic ne stocke qu’une empreinte cryptographique ; une clé perdue est remplacée, jamais récupérée.
Effectuez une rotation en générant une nouvelle clé puis en révoquant l’ancienne. Aucune étape du processus ne nécessite de contacter une personne.
En cas d’échec
Une réponse 401 vous indique la prochaine étape à suivre.
- HTTP 401Informations d’authentification manquantes ou invalides
- RFC 9728Métadonnées de la ressource protégée
- RFC 8414Métadonnées du serveur d’autorisation
Un identifiant manquant ou invalide renvoie HTTP 401 avec un en-tête WWW-Authenticate indiquant le document Protected Resource Metadata (RFC 9728). En le suivant, on accède aux métadonnées du serveur d’autorisation (RFC 8414), ce qui permet à un client recevant une réponse 401 de découvrir comment s’authentifier sans qu’une personne ait besoin de lire la documentation.
Sur la surface REST, le corps est un problème RFC 9457 avec code: "unauthenticated". Sur le point d’accès MCP, il s’agit d’une erreur JSON-RPC avec le code -32001 et un indice resource_metadata dans error.data.
Les identifiants ne sont jamais requis pour évaluer ecentic — uniquement pour agir sur un compte marchand.