Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Autentifikacija Partner API-ja: Bearer ec_live_ ključevi, rotacija i pogreške 401

Svaki zahtjev Partner API-ja nosi tajni ključ računa u zaglavlju Authorization: Bearer ec_live_…, koji šalje vaš poslužitelj. Svaki račun easyCoexistence ima jedan ključ, stvoren na nadzornoj ploči pod Profil, Programeri ili zamolbom AI asistentu da pokrene create_api_key, i prikazan samo jednom. Rotacija izdaje novi ključ i odmah okončava stari; nedostajući ili pogrešan ključ dobiva 401 unauthorized.

ec_live_

Prefiks s kojim počinje svaki ključ Partner API-ja, šalje se uz svaki zahtjev kao Authorization: Bearer.

1 key

Ključeva koje račun istodobno drži; svaka veza napravljena njime pripada tom računu.

401

Status za nedostajući ili neispravan ključ, s kôdom pogreške unauthorized i porukom koja imenuje očekivano zaglavlje.

Once

Kada se prikazuje cijeli ključ, pri stvaranju ili rotaciji; poslije su vidljivi samo prvi znakovi.

Kako zahtjev dolazi do autentifikacije?

Ključem kao Bearer tokenom u zaglavlju Authorization svakog zahtjeva prema https://easycoexistence.com/api/v1. Ništa drugo se ne potpisuje niti ograničava na opseg: ključ identificira račun, a sve što zahtjev stvori ili pročita pripada tom računu. Tijela zahtjeva su JSON, a svaka pogreška vraća se kao objekt s kôdom i porukom.

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

Gdje stvarate ključ?

Na nadzornoj ploči ili iz AI asistenta, s istim rezultatom. Na nadzornoj ploči otvorite Profil, zatim Programeri, i pritisnite Stvori API ključ. U Claudeu, ChatGPT-u ili nekom drugom asistentu povezanom s easyCoexistence MCP poslužiteljem zamolite ga da postavi Partner API: get_partner_setup pokazuje što nedostaje, a create_api_key vraća ključ. U oba slučaja cijeli ključ se pojavi samo jednom, pa ga odmah spremite u tajne podatke vašeg backenda.

Zašto se ključ prikazuje samo jednom?

Jer se pohranjuje samo njegov hash. easyCoexistence čuva hash radi provjere svakog zahtjeva, uz prve znakove ključa, ec_live_ i još šest, kako nadzorna ploča može pokazati koji je ključ aktivan i kada je stvoren. Izgubljeni ključ se ne može ponovno prikazati; rotacija ga zamjenjuje.

Kako rotirate ili opozivate ključ?

U jednom koraku, a stari ključ prestaje raditi u tom trenutku, bez razdoblja milosti, jer je curenje najčešći razlog za rotaciju. Novi ključ se prikazuje jednom, kao i prvi:

  • Nadzorna ploča: Profil, Programeri, Rotiraj ključ.
  • MCP: create_api_key s replace_existing postavljenim na true. Bez toga alat odbija rad dok ključ postoji, pa se pokrenuta integracija ne prekida slučajno.
  • Za zaustavljanje svakog pristupa opozovite ključ: Opozovi na nadzornoj ploči ili revoke_api_key s confirm postavljenim na true. Zahtjevi tada ne uspijevaju dok se ne stvori novi ključ.

Što vraća nedostajući ili pogrešan ključ?

401 s kôdom unauthorized, za zahtjev bez zaglavlja Authorization, ključ koji ne počinje s ec_live_, ili ključ koji je rotiran ili opozvan. Poruka imenuje zaglavlje koje se očekuje. Kada neuspjeli zahtjevi stižu s jedne adrese, API umjesto toga odgovara s 429 rate_limited, uz broj sekundi za čekanje prije ponovnog pokušaja.

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

Što još valjani ključ može odbiti?

Valjani ključ autentificira račun, a stanje računa i dalje vrijedi. Ti odgovori dolaze s istim oblikom pogreške:

  • 402 billing_required: na računu još nema kartice, pa ne može započeti sesije povezivanja.
  • 404 not_found: identifikator ne pripada nijednoj vezi, kanalu ili sesiji ovog računa, uključujući one na drugim računima.
  • 409 removed: veza je uklonjena, pa se njezin webhook ne može mijenjati.
  • 402 suspended: veza je suspendirana nakon istekle pretplate; najprije je ponovno povežite.
  • 429 cap_reached ili rate_limited: previše otvorenih sesija povezivanja ili previše stvorenih u ovom satu.

Uobičajene pogreške

  • Stavljanje ključa u kôd sučelja. Svatko tko otvori stranicu može ga pročitati, stvoriti veze naplaćene vama i dohvatiti tokene vaših kupaca s ?credentials=1.
  • Rotacija prije nego backend može primiti novi ključ. Stari ključ prestaje odmah, pa svaki zahtjev dobiva 401 dok se novi ne postavi.
  • Stvaranje ključa u razgovoru koji dijelite. create_api_key vraća ključ u chatu, gdje ostaje u povijesti, pa ga rotirajte ako je razgovor dijeljen.
  • Pohranjivanje ključa s navodnicima oko njega. Sve nakon Bearer čita se kao ključ, pa navodnička vrijednost nikad ne odgovara i svaki zahtjev dobiva 401.
Radite ovo uz EasyCoexistence

easyCoexistence daje svakom računu jedan Partner API ključ, pa vaš backend može povezati WhatsApp brojeve vaših kupaca te njihove Instagram, Facebook, TikTok, YouTube i LinkedIn račune, i ostale kanale, zatim očitati vjerodajnice svake veze i usmjeriti njezine događaje. Od US$ 9 do US$ 0,75 po vezi mjesečno, cijena pada kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Može li račun imati više API ključeva?

Ne. Račun u jednom trenutku ima jedan ključ, a stvaranje novog zamjenjuje stari. Odvojeni ključevi znače odvojene račune easyCoexistence, svaki sa svojim vezama i naplatom.

Istječu li Partner API ključevi?

Ne. Ključ radi dok se ne rotira ili opozove, ili dok easyCoexistence ne prekine njegov rad zbog zloupotrebe Metinih pravila.

Trebaju li moji kupci moj ključ za povezivanje?

Ne. Oni samo otvaraju hostirani link za povezivanje, koji nosi vlastiti identifikator sesije. Ključ ostaje na vašem poslužitelju i koristi ga isključivo vaš backend.

Je li API ključ isti kao tajna za potpisivanje događaja?

Ne. Ključ autentificira vaše zahtjeve prema API-ju. Tajna za potpisivanje, prikazana jednom kada postavite URL za događaje o statusu, omogućuje vašem endpointu da provjeri događaje koje easyCoexistence šalje.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na