AccediInizia la prova gratuita
easyCoexistence API ufficiali

Autenticazione Partner API: chiavi Bearer ec_live_, rotazione ed errori 401

Ogni richiesta alla Partner API porta la chiave segreta dell'account nell'intestazione Authorization: Bearer ec_live_…, inviata dal tuo server. Ogni account easyCoexistence ha una sola chiave, creata nella dashboard sotto Profilo, Sviluppatori, oppure chiedendo a un assistente AI di eseguire create_api_key, e mostrata una sola volta. Ruotare la chiave ne emette una nuova e termina subito quella vecchia; una chiave mancante o errata restituisce 401 unauthorized.

ec_live_

Il prefisso con cui inizia ogni chiave della Partner API, inviata in ogni richiesta come Authorization: Bearer.

1 key

Chiavi che un account detiene alla volta; ogni connessione creata con una di esse appartiene all'account.

401

Stato per una chiave mancante o non valida, con il codice di errore unauthorized e un messaggio che indica l'intestazione prevista.

Once

Quante volte viene mostrata la chiave completa: alla creazione o alla rotazione; dopo, sono visibili solo i primi caratteri.

Come si autentica una richiesta?

Con la chiave come token Bearer nell'intestazione Authorization di ogni richiesta a https://easycoexistence.com/api/v1. Non viene firmato né limitato altro: la chiave identifica l'account, e tutto ciò che una richiesta crea o legge appartiene a quell'account. Il corpo delle richieste è JSON, e ogni errore arriva come oggetto con un codice e un messaggio.

List the account's numbers
curl https://easycoexistence.com/api/v1/connections \
  -H "Authorization: Bearer $EC_API_KEY"

Dove si crea la chiave?

Nella dashboard o da un assistente AI, con lo stesso risultato. Nella dashboard, apri Profilo, poi Sviluppatori, e premi Crea API key. In Claude, ChatGPT o in un altro assistente collegato al server MCP di easyCoexistence, chiedigli di configurare la Partner API: get_partner_setup mostra cosa manca e create_api_key restituisce la chiave. In ogni caso la chiave completa compare una sola volta, quindi salvala subito nei segreti del tuo backend.

Perché la chiave si mostra una sola volta?

Perché ne viene salvato solo un hash. easyCoexistence conserva l'hash per verificare ogni richiesta, più i primi caratteri della chiave, ec_live_ più altri sei, così la dashboard può mostrare quale chiave è attiva e quando è stata creata. Una chiave persa non può essere mostrata di nuovo; ruotarla la sostituisce.

Come si ruota o si revoca la chiave?

In un solo passaggio, e la vecchia chiave smette di funzionare in quel momento, senza periodo di tolleranza, perché una perdita è il motivo più comune per ruotare. La nuova chiave viene mostrata una sola volta, come la prima:

  • Dashboard: Profilo, Sviluppatori, Ruota chiave.
  • MCP: create_api_key con replace_existing impostato su true. Senza questo, lo strumento rifiuta finché esiste una chiave, così un'integrazione in funzione non si interrompe per sbaglio.
  • Per bloccare invece ogni accesso, revoca: Revoca nella dashboard, oppure revoke_api_key con confirm impostato su true. Le richieste poi falliscono finché non viene creata una nuova chiave.

Cosa restituisce una chiave mancante o errata?

Un 401 con il codice unauthorized, per una richiesta senza intestazione Authorization, una chiave che non inizia con ec_live_, o una chiave ruotata o revocata. Il messaggio indica l'intestazione prevista. Quando le richieste fallite continuano a provenire da uno stesso indirizzo, l'API risponde invece 429 rate_limited, con i secondi da attendere prima di riprovare.

401 Unauthorized
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
  }
}

Cos'altro può rifiutare una chiave valida?

Una chiave valida autentica l'account, e lo stato dell'account continua ad applicarsi. Questi casi restituiscono la stessa forma di errore:

  • 402 billing_required: non c'è ancora una carta sull'account, quindi non può avviare sessioni di connessione.
  • 404 not_found: l'id non appartiene a nessuna connessione, canale o sessione di questo account, incluse quelle di altri account.
  • 409 removed: la connessione è stata rimossa, quindi il suo webhook non può più cambiare.
  • 402 suspended: la connessione è sospesa dopo un abbonamento scaduto; riconnettila prima.
  • 429 cap_reached o rate_limited: troppe sessioni di connessione aperte, o troppe create in quest'ora.

Errori comuni

  • Mettere la chiave nel codice front-end. Chiunque apra la pagina può leggerla, creare connessioni addebitate a te e recuperare i token dei tuoi clienti con ?credentials=1.
  • Ruotare prima che il backend possa usare la nuova chiave. La vecchia chiave si ferma subito, quindi ogni richiesta fallisce con 401 finché quella nuova non è distribuita.
  • Creare la chiave in una conversazione condivisa. create_api_key la restituisce in chat, dove resta nella cronologia, quindi ruotala se quella conversazione è condivisa.
  • Salvare la chiave con le virgolette attorno. Tutto ciò che segue Bearer viene letto come chiave, quindi un valore tra virgolette non corrisponde mai e ogni richiesta riceve 401.
Farlo con EasyCoexistence

easyCoexistence assegna a ogni account una chiave della Partner API, così il tuo backend può collegare i numeri WhatsApp dei tuoi clienti e i loro account Instagram, Facebook, TikTok, YouTube e LinkedIn, e altri canali, poi leggere le credenziali di ogni connessione e instradarne gli eventi. Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.

Domande frequenti

Un account può avere più di una chiave API?

No. Un account ha una chiave alla volta, e crearne una nuova sostituisce quella precedente. Chiavi separate significano account easyCoexistence separati, ciascuno con le proprie connessioni e la propria fattura.

Le chiavi della Partner API scadono?

No. Una chiave funziona finché non viene ruotata o revocata, o finché easyCoexistence non la termina per abuso delle regole di Meta.

I miei clienti hanno bisogno della mia chiave per connettersi?

No. Aprono soltanto il link di connessione ospitato, che porta con sé un proprio id di sessione. La chiave resta sul tuo server e viene usata solo dal tuo backend.

La chiave API è la stessa cosa del segreto di firma degli eventi?

No. La chiave autentica le tue richieste all'API. Il segreto di firma, mostrato una sola volta quando imposti un URL per gli eventi di stato, permette al tuo endpoint di verificare gli eventi che easyCoexistence invia.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il