Vai al contenuto

Documentazione ecentic per sviluppatori.

Tutto ciò che serve a un agente o a un ingegnere per chiamare ecentic: una REST API versionata, un server MCP, errori tipizzati, limiti di frequenza pubblicati e i documenti di discovery che permettono a un crawler di trovare tutto senza intervento umano.

Gli endpoint pubblici non richiedono una chiave · OpenAPI 3.1 · Errori RFC 9457

01

Chiama ecentic con una sola richiesta

La superficie pubblica non richiede autenticazione ed è aperta al CORS. Inizia da qui, poi genera una chiave solo quando devi agire su un account commerciante.

02

Autenticazione

Le letture pubbliche sono aperte. Qualsiasi operazione che coinvolga un account merchant richiede una chiave bearer.

ecentic rilascia API key a lunga durata dopo che una persona crea un account. Crea l'account, genera una chiave dalla dashboard o tramite lo strumento MCP autenticato create_api_key, quindi inviala come bearer token in ogni chiamata protetta. La chiave viene mostrata una sola volta.

Le chiamate protette senza una chiave valida restituiscono HTTP 401 e un header WWW-Authenticate che indica il documento Protected Resource Metadata, così un agente può rieseguire la discovery direttamente dall'errore invece di procedere per tentativi.

  • mcp — chiama gli strumenti MCP tramite l'endpoint MCP di ecentic
  • onboarding — collega Shopify, WooCommerce e store con feed di prodotti
POST https://ecentic.ai/api/mcp
03

Endpoint

La superficie REST versionata. I percorsi sotto /api/v1 restano stabili per tutta la durata di v1.

04

Protocolli per agenti

ecentic supporta i protocolli di commercio e degli strumenti che gli agenti già utilizzano e pubblica un manifest per ciascuno.

06

Server MCP

Claude, ChatGPT e qualsiasi client MCP possono chiamare ecentic in modo nativo.

Il server MCP di ecentic utilizza JSON-RPC 2.0 su HTTP ed è raggiungibile sia da /mcp sia da /api/mcp. Il suo manifest è pubblicato nel percorso well-known convenzionale e come server card SEP-1649.

Gli strumenti di sola lettura (list_plans) funzionano senza autenticazione. Gli strumenti che modificano lo stato dell'account — creazione di chiavi, avvio del checkout, collegamento di uno store — richiedono una bearer key.

  • list_plans — piani e relativa disponibilità su Stripe
  • create_api_key — genera una chiave agente a lunga durata
  • create_checkout — apre una sessione di checkout Stripe
  • connect_shopify, connect_woocommerce, connect_feed — onboarding dello store
https://ecentic.ai/.well-known/mcp.json
Server MCP
07

Webhook

ecentic riceve webhook; al momento non li invia in uscita.

Gli endpoint in ingresso verificano la firma e rifiutano qualsiasi richiesta che non superi il controllo prima dell'esecuzione di qualsiasi handler. I webhook di conformità Shopify verificano un HMAC, Stripe verifica il proprio header di firma e gli endpoint partner verificano un bearer secret.

I webhook in uscita — notifiche di ecentic al tuo sistema quando una scansione termina o una scheda prodotto viene ripubblicata — non sono ancora pubblicati. Leggi i risultati di scansioni e schede prodotto nella dashboard. La REST API pubblicata non espone questi risultati della dashboard; usa il riferimento API per le operazioni attualmente disponibili. Le richieste MCP sono senza stato; non esiste una sessione di sottoscrizione.

08

Riga di comando

Automatizza ecentic senza scrivere un client HTTP.

La CLI di ecentic utilizza la stessa superficie pubblica documentata qui — discovery, piani, funzionalità, stato di salute e chiamate agli strumenti MCP — così un agente o uno sviluppatore può usare la shell invece di creare un'integrazione.

Legge ECENTIC_API_KEY dall'ambiente per i comandi autenticati e stampa JSON su stdout, così ogni comando è compatibile con jq.

Esempio di codice

Ogni documento in questa pagina è leggibile da macchina e accessibile senza chiave.