Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Autentificarea Partner API: chei Bearer ec_live_, rotație și erori 401

Fiecare cerere Partner API transmite cheia secretă a contului în antetul Authorization: Bearer ec_live_…, trimisă de la serverul dumneavoastră. Fiecare cont easyCoexistence are o singură cheie, creată în dashboard, la Profile, Developers, sau cerând unui asistent AI să ruleze create_api_key, și afișată o singură dată. Rotirea emite o cheie nouă și oprește imediat cheia veche; o cheie lipsă sau greșită primește eroarea 401 unauthorized.

ec_live_

Prefixul cu care începe fiecare cheie Partner API, trimis la fiecare cerere ca Authorization: Bearer.

1 key

Câte chei deține un cont în același timp; fiecare conexiune creată cu ele aparține contului respectiv.

401

Statusul pentru o cheie lipsă sau invalidă, cu codul de eroare unauthorized și un mesaj care numește antetul așteptat.

Once

De câte ori se afișează cheia completă, la creare sau la rotire; după aceea sunt vizibile doar primele caractere.

Cum autentifică o cerere cheia?

Cu cheia drept token Bearer în antetul Authorization al fiecărei cereri către https://easycoexistence.com/api/v1. Nu se semnează și nu se restricționează nimic altceva: cheia identifică contul, iar tot ce creează sau citește o cerere aparține acelui cont. Corpul cererilor este JSON, iar fiecare eroare vine ca un obiect cu un cod și un mesaj.

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

De unde creezi cheia?

În dashboard sau de la un asistent AI, cu același rezultat. În dashboard, deschideți Profile, apoi Developers, și apăsați Create API key. În Claude, ChatGPT sau alt asistent conectat la serverul MCP al easyCoexistence, cereți-i să configureze Partner API: get_partner_setup arată ce lipsește, iar create_api_key returnează cheia. În ambele cazuri cheia completă apare o singură dată, așa că o salvați imediat în secretele backend-ului dumneavoastră.

De ce cheia este afișată o singură dată?

Pentru că se stochează doar un hash al ei. easyCoexistence păstrează hash-ul pentru a verifica fiecare cerere, plus primele caractere ale cheii, ec_live_ și încă șase, ca dashboard-ul să poată arăta ce cheie este activă și când a fost creată. O cheie pierdută nu mai poate fi afișată; rotirea o înlocuiește.

Cum rotești sau revoci cheia?

Într-un singur pas, iar cheia veche încetează să mai funcționeze în acel moment, fără perioadă de grație, deoarece motivul obișnuit pentru rotire este o scurgere. Cheia nouă se afișează o singură dată, ca prima:

  • Dashboard: Profile, Developers, Rotate key.
  • MCP: create_api_key cu replace_existing setat la true. Fără el, unealta refuză cât timp există o cheie, astfel încât o integrare în funcțiune nu se rupe din greșeală.
  • Pentru a opri tot accesul, revocați: Revoke în dashboard sau revoke_api_key cu confirm setat la true. Cererile eșuează apoi până se creează o cheie nouă.

Ce returnează o cheie lipsă sau greșită?

Un 401 cu codul unauthorized, pentru o cerere fără antet Authorization, pentru o cheie care nu începe cu ec_live_ sau pentru o cheie care a fost rotită ori revocată. Mesajul numește antetul așteptat. Când cererile eșuate vin continuu de la aceeași adresă, API-ul răspunde în schimb cu 429 rate_limited, împreună cu numărul de secunde de așteptat înainte de o nouă încercare.

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

Ce altceva poate refuza o cheie validă?

O cheie validă autentifică contul, iar starea contului se aplică în continuare. Acestea vin cu aceeași structură de eroare:

  • 402 billing_required: contul nu are încă un card, deci nu poate porni sesiuni de conectare.
  • 404 not_found: id-ul nu aparține niciunei conexiuni, niciunui canal sau niciunei sesiuni din acest cont, inclusiv celor din alte conturi.
  • 409 removed: conexiunea a fost eliminată, așa că webhook-ul ei nu mai poate fi modificat.
  • 402 suspended: conexiunea este suspendată după un abonament expirat; reconectați-o mai întâi.
  • 429 cap_reached sau rate_limited: prea multe sesiuni de conectare deschise sau prea multe create în ultima oră.

Greșeli frecvente

  • Punerea cheii în codul front-end. Oricine deschide pagina o poate citi, poate crea conexiuni facturate dumneavoastră și poate obține token-urile clienților cu ?credentials=1.
  • Rotirea înainte ca backend-ul să poată prelua cheia nouă. Cheia veche se oprește imediat, deci fiecare cerere eșuează cu 401 până se livrează cea nouă.
  • Crearea cheii într-o conversație partajată. create_api_key o returnează în chat, unde rămâne în istoric, deci rotiți-o dacă acea conversație este partajată.
  • Salvarea cheii între ghilimele. Tot ce urmează după Bearer este citit ca fiind cheia, deci o valoare între ghilimele nu se potrivește niciodată și fiecare cerere primește 401.
Faceți acest lucru cu EasyCoexistence

easyCoexistence oferă fiecărui cont o singură cheie Partner API, astfel încât backend-ul dumneavoastră să poată conecta numerele WhatsApp ale clienților și conturile lor Instagram, Facebook, TikTok, YouTube și LinkedIn, plus alte canale, apoi să citească acreditările fiecărei conexiuni și să direcționeze evenimentele. De la US$ 9 până la US$ 0.75 pe conexiune pe lună, cu scădere pe măsură ce adăugați conexiuni, și primele 3 zile gratuite.

Întrebări frecvente

Poate avea un cont mai multe chei Partner API?

Nu. Un cont are o cheie la un moment dat, iar crearea uneia noi o înlocuiește. Chei separate înseamnă conturi easyCoexistence separate, fiecare cu propriile conexiuni și propria factură.

Expiră cheile Partner API?

Nu. O cheie funcționează până când este rotită sau revocată, ori până când easyCoexistence o oprește pentru abuz al regulilor Meta.

Au nevoie clienții mei de cheia mea pentru a se conecta?

Nu. Ei deschid doar linkul de conectare găzduit, care are propriul id de sesiune. Cheia rămâne pe serverul dumneavoastră și este folosită doar de backend-ul dumneavoastră.

Cheia API este același lucru cu secretul de semnare al evenimentelor?

Nu. Cheia autentifică cererile dumneavoastră către API. Secretul de semnare, afișat o singură dată când setați un URL de evenimente de status, permite endpoint-ului dumneavoastră să verifice evenimentele trimise de easyCoexistence.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la