Vai al contenuto

API ecentic: autenticazione.

La discovery pubblica non richiede alcuna credenziale. Tutto ciò che legge o modifica un account merchant richiede una chiave bearer che generi autonomamente — nessuna chiamata commerciale, nessun provisioning manuale.

Chiavi self-service · Bearer token · Metadati OAuth

01

Scegli un percorso di richiesta

Esplora prima l’API. Aggiungi una chiave bearer quando il tuo client agisce su un account merchant.

Il tuo client

Nessuna credenziale richiesta

Discovery + sandbox

Cosa non richiede una chiave

La discovery è aperta, intenzionalmente.

Nessuna credenziale richiesta

02

Generare una chiave

Due percorsi self-service, entrambi sotto il tuo controllo.

  1. Crea un account
  2. Genera una chiave
  3. Salvala una sola volta

Crea un account, poi genera una chiave dalla dashboard oppure chiamando lo strumento MCP create_api_key da una sessione autenticata. Le chiavi hanno formato ecentic_sk_…, sono a lunga durata e vengono mostrate una sola volta — ecentic conserva solo un hash, quindi una chiave persa va sostituita e non recuperata.

Per ruotarle, genera una nuova chiave e revoca quella precedente. Nessuna parte del processo richiede di contattare una persona.

Guida completa alla registrazione
03

Quando fallisce

Un 401 indica il passaggio successivo.

  1. HTTP 401Credenziale mancante o non valida
  2. RFC 9728Metadati della risorsa protetta
  3. RFC 8414Metadati del server di autorizzazione
401

Una credenziale mancante o non valida restituisce HTTP 401 con un header WWW-Authenticate che indica il documento Protected Resource Metadata (RFC 9728). Seguendolo si arriva ai metadati del server di autorizzazione (RFC 8414), così un client che riceve un 401 può scoprire come autenticarsi senza che una persona debba leggere la documentazione.

Sulla superficie REST il body è un problem RFC 9457 con code: "unauthenticated". Sull’endpoint MCP è un errore JSON-RPC con codice -32001 e un suggerimento resource_metadata in error.data.

Le credenziali non sono mai necessarie per valutare ecentic — solo per agire su un account merchant.