Autentifikacija Partner API: Bearer ec_live_ ključevi, rotacija i greške 401
Svaki zahtev ka Partner API-ju nosi tajni ključ naloga u zaglavlju Authorization: Bearer ec_live_…, koji šalje vaš server. Svaki easyCoexistence nalog ima jedan ključ, koji se pravi u kontrolnoj tabli pod Profile, Developers, ili tako što AI asistenta zamolite da pokrene create_api_key, i prikazuje se samo jednom. Rotacija izdaje novi ključ i odmah prekida stari; nedostajući ili pogrešan ključ dobija 401 unauthorized.
Prefiks kojim počinje svaki Partner API ključ, šalje se u svakom zahtevu kao Authorization: Bearer.
Broj ključeva koje nalog drži u isto vreme; svaka veza napravljena ovim ključem pripada tom nalogu.
Status za nedostajući ili neispravan ključ, sa kodom unauthorized i porukom koja navodi očekivano zaglavlje.
Koliko puta se pun ključ prikazuje, pri kreiranju ili rotaciji; kasnije su vidljivi samo prvi znakovi.
Kako zahtev dobija autentifikaciju?
Ključem kao Bearer tokenom u zaglavlju Authorization svakog zahteva ka https://easycoexistence.com/api/v1. Ništa drugo se ne potpisuje niti ograničava obimom: ključ identifikuje nalog, a sve što zahtev kreira ili čita pripada tom nalogu. Tela su u JSON formatu, a svaka greška stiže kao objekat sa kodom i porukom.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Gde se ključ pravi?
U kontrolnoj tabli ili preko AI asistenta, sa istim rezultatom. U kontrolnoj tabli otvorite Profile, zatim Developers, i pritisnite Create API key. U Claude, ChatGPT ili drugom asistentu povezanom na easyCoexistence MCP server, zamolite ga da podesi Partner API: get_partner_setup pokazuje šta nedostaje, a create_api_key vraća ključ. Na oba načina pun ključ se pojavi jednom, zato ga odmah sačuvajte u tajnama vašeg backenda.
Zašto se ključ prikazuje samo jednom?
Zato što se čuva samo njegov hash. easyCoexistence čuva hash za proveru svakog zahteva, plus prve znakove ključa, ec_live_ i još šest, da kontrolna tabla može da prikaže koji ključ je aktivan i kada je napravljen. Izgubljeni ključ se ne može ponovo prikazati; rotacija ga zamenjuje.
Kako se ključ rotira ili opoziva?
U jednom koraku, a stari ključ prestaje da radi u tom trenutku, bez perioda milosti, jer je curenje najčešći razlog za rotaciju. Novi ključ se prikazuje jednom, kao i prvi:
- Kontrolna tabla: Profile, Developers, Rotate key.
- MCP:
create_api_keysareplace_existingpostavljenim na true. Bez toga alat odbija rad dok ključ postoji, pa se aktivna integracija ne prekida slučajno. - Da biste zaustavili sav pristup, opozovite: Revoke u kontrolnoj tabli ili
revoke_api_keysa confirm postavljenim na true. Zahtevi tada ne uspevaju dok se ne napravi novi ključ.
Šta vraća nedostajući ili pogrešan ključ?
401 sa kodom unauthorized, za zahtev bez zaglavlja Authorization, ključ koji ne počinje sa ec_live_, ili ključ koji je rotiran ili opozvan. Poruka navodi zaglavlje koje se očekuje. Kada neuspeli zahtevi dolaze sa iste adrese, API umesto toga odgovara sa 429 rate_limited, uz broj sekundi za čekanje pre ponovnog pokušaja.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Šta sve validan ključ može da odbije?
Validan ključ autentifikuje nalog, a stanje naloga i dalje važi. Ovi odgovori stižu sa istim oblikom greške:
- 402
billing_required: na nalogu još nema kartice, pa ne mogu da se pokrenu sesije povezivanja. - 404
not_found: id ne pripada nijednoj vezi, kanalu ili sesiji ovog naloga, uključujući one na drugim nalozima. - 409 removed: veza je uklonjena, pa njen webhook ne može da se menja.
- 402 suspended: veza je suspendovana posle istekle pretplate; prvo je ponovo povežite.
- 429
cap_reachedilirate_limited: previše otvorenih sesija povezivanja, ili previše napravljenih u ovom satu.
Česte greške
- Stavljanje ključa u frontend kod. Svako ko otvori stranicu može da ga pročita, napravi veze naplaćene vama i preuzme tokene vaših klijenata sa ?credentials=1.
- Rotacija pre nego što backend može da primi novi ključ. Stari ključ prestaje odmah, pa svaki zahtev dobija 401 dok se novi ne objavi.
- Pravljenje ključa u razgovoru koji delite. create_api_key ga vraća u četu, gde ostaje u istoriji, pa ga rotirajte ako je razgovor podeljen.
- Čuvanje ključa sa navodnicima oko njega. Sve posle Bearer čita se kao ključ, pa ključ u navodnicima nikad ne odgovara i svaki zahtev dobija 401.
easyCoexistence daje svakom nalogu jedan Partner API ključ, pa vaš backend može da poveže WhatsApp brojeve vaših klijenata i njihove naloge na Instagramu, Facebooku, TikToku, YouTubeu i LinkedInu, i još kanala, zatim čita podatke za prijavu svake veze i usmerava njene događaje. Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze. Uz besplatni probni period od 3 dana.
Često postavljana pitanja
Može li nalog da ima više API ključeva?
Ne. Nalog ima jedan ključ u isto vreme, a pravljenje novog zamenjuje stari. Odvojeni ključevi znače odvojene easyCoexistence naloge, svaki sa sopstvenim vezama i sopstvenom naplatom.
Da li Partner API ključevi ističu?
Ne. Ključ radi dok se ne rotira ili opozove, ili dok ga easyCoexistence ne prekine zbog zloupotrebe Metinih pravila.
Da li moji klijenti trebaju moj ključ za povezivanje?
Ne. Oni samo otvore hostovani link za povezivanje, koji nosi sopstveni id sesije. Ključ ostaje na vašem serveru i koristi ga isključivo vaš backend.
Da li je API ključ isti kao tajna za potpisivanje događaja?
Ne. Ključ autentifikuje vaše zahteve ka API-ju. Tajna za potpisivanje, prikazana jednom kada podesite URL za događaje statusa, omogućava vašem endpointu da proveri događaje koje easyCoexistence šalje.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na