Aller au contenu

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

01

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.

Aucun identifiant requis

02

Générer une clé

Deux parcours en libre-service, tous deux sous votre contrôle.

  1. Créer un compte
  2. Générer une clé
  3. 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.

Guide d’inscription complet
03

En cas d’échec

Une réponse 401 vous indique la prochaine étape à suivre.

  1. HTTP 401Informations d’authentification manquantes ou invalides
  2. RFC 9728Métadonnées de la ressource protégée
  3. RFC 8414Métadonnées du serveur d’autorisation
401

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.