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
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.
Ogni endpoint sotto /api/v1 risponde senza un header Authorization, così come i documenti standard di discovery, il documento OpenAPI e lo strumento MCP list_plans. Un agente può conoscere l’intera struttura dell’API — endpoint, piani, protocolli, skill, limiti di frequenza, codici di errore — prima ancora che qualcuno abbia creato un account.
Anche la sandbox è aperta: POST /api/v1/sandbox/simulation restituisce l’esatta struttura di risposta di una simulazione reale, calcolata a partire da punteggi sintetici, così un client può essere sviluppato e testato senza alcuna credenziale.
Il tuo client
Chiave bearer richiesta
REST + MCP
Inviare una chiave
Un solo header, ovunque.
Invia la chiave come bearer token in ogni richiesta protetta. Lo stesso header funziona sia sulla superficie REST sia nelle chiamate agli strumenti MCP.
Non inserire la chiave nella query string: le query string finiscono nei log, nei proxy e negli header referrer, ed ecentic non le legge da lì.
Generare una chiave
Due percorsi self-service, entrambi sotto il tuo controllo.
- Crea un account
- Genera una chiave
- 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.
Quando fallisce
Un 401 indica il passaggio successivo.
- HTTP 401Credenziale mancante o non valida
- RFC 9728Metadati della risorsa protetta
- RFC 8414Metadati del server di autorizzazione
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.