Partner API authentication: Bearer ec_live_ keys, rotation, at 401 errors
Bawat Partner API request ay may dalang secret key ng account sa header na Authorization: Bearer ec_live_…, na ipinapadala mula sa inyong server. Bawat easyCoexistence account ay may isang key, na ginagawa sa dashboard sa ilalim ng Profile, Developers, o sa paghiling sa AI assistant na patakbuhin ang create_api_key, at ipinapakita lamang nang isang beses. Ang pag-rotate ay naglalabas ng bagong key at agad tinatapos ang luma; ang kulang o maling key ay nakakakuha ng 401 unauthorized.
Ang prefix na sinisimulan ng bawat Partner API key, ipinapadala sa bawat request bilang Authorization: Bearer.
Bilang ng key na hawak ng account sa isang pagkakataon; bawat connection na ginawa gamit ito ay kabilang sa account na iyon.
Status para sa kulang o maling key, may error code na unauthorized at mensaheng nagsasaad ng inaasahang header.
Ilang beses ipinapakita ang buong key, kapag ginawa o na-rotate; pagkatapos, ang unang ilang karakter lang ang nakikita.
Paano nag-a-authenticate ang request?
Gamit ang key bilang Bearer token sa Authorization header ng bawat request sa https://easycoexistence.com/api/v1. Walang ibang pinipirmahan o nilalagyan ng saklaw: kinikilala ng key ang account, at lahat ng nilikha o binabasa ng request ay kabilang sa account na iyon. Ang body ay JSON, at ang bawat error ay bumabalik bilang object na may code at message.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Saan ginagawa ang key?
Sa dashboard o mula sa AI assistant, na may parehong resulta. Sa dashboard, buksan ang Profile, pagkatapos Developers, at pindutin ang Create API key. Sa Claude, ChatGPT o ibang assistant na konektado sa MCP server ng easyCoexistence, hilingin na i-set up ang Partner API: ipinapakita ng get_partner_setup kung ano ang kulang, at ibinabalik ng create_api_key ang key. Sa alinmang paraan, lumalabas nang isang beses ang buong key, kaya itago agad ito sa secrets ng inyong backend.
Bakit isang beses lang ipinapakita ang key?
Dahil hash lamang nito ang iniimbak. Iniimbak ng easyCoexistence ang hash para suriin ang bawat request, kasama ang unang mga karakter ng key, ec_live_ at anim pa, para maipakita ng dashboard kung aling key ang aktibo at kailan ito ginawa. Hindi na maipapakita ang nawalang key; ang pag-rotate ang pumapalit dito.
Paano i-rotate o i-revoke ang key?
Sa isang hakbang, at titigil agad sa paggana ang lumang key sa sandaling iyon, walang grace period, dahil karaniwang dahilan ng pag-rotate ang pagtagas ng key. Ang bagong key ay lumalabas nang isang beses, gaya ng una:
- Dashboard: Profile, Developers, Rotate key.
- MCP:
create_api_keyna mayreplace_existingna nakatakda sa true. Kung wala ito, tatanggi ang tool habang may umiiral na key, para hindi masira nang hindi sinasadya ang tumatakbong integration. - Para itigil ang lahat ng access, i-revoke sa halip: Revoke sa dashboard, o
revoke_api_keyna may confirm na nakatakda sa true. Mabibigo ang mga request hanggang may bagong key na nagawa.
Ano ang ibinabalik ng kulang o maling key?
Isang 401 na may code na unauthorized, para sa request na walang Authorization header, key na hindi nagsisimula sa ec_live_, o key na na-rotate o na-revoke. Ipinapangalan ng mensahe ang header na inaasahan. Kapag paulit-ulit na nanggagaling ang nabigong request sa iisang address, ang API ay sumasagot ng 429 rate_limited sa halip, kasama ang bilang ng segundong dapat hintayin bago muling subukan.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Ano pa ang maaaring tanggihan sa isang valid na key?
Pinatutunayan ng valid na key ang account, at umiiral pa rin ang estado ng account. Ang mga ito ay bumabalik na may parehong hugis ng error:
- 402
billing_required: walang card ang account, kaya hindi makakapagsimula ng connect session. - 404
not_found: ang id ay hindi kabilang sa anumang connection, channel o session ng account na ito, pati ang mga nasa ibang account. - 409 removed: inalis na ang connection, kaya hindi na mababago ang webhook nito.
- 402 suspended: sinuspinde ang connection dahil sa napaso na subscription; i-reconnect muna ito.
- 429
cap_reachedorate_limited: masyadong maraming bukas na connect session, o masyadong maraming nagawa ngayong oras.
Mga karaniwang pagkakamali
- Paglalagay ng key sa front-end code. Sinumang magbukas ng pahina ay mababasa ito, makakagawa ng connection na sisingilin sa inyo, at makukuha ang token ng mga customer ninyo gamit ang ?credentials=1.
- Pag-rotate bago kayang tanggapin ng inyong backend ang bagong key. Agad titigil ang lumang key, kaya bawat request ay mabibigo sa 401 hanggang ma-deploy ang bago.
- Paggawa ng key sa usapang ibinabahagi ninyo. Ibinabalik ng create_api_key ang key sa chat, at nananatili ito sa history, kaya i-rotate ito kung ibinabahagi ang usapan.
- Pagtatago ng key na may quotes. Lahat ng nasa likod ng Bearer ay binabasang key, kaya hindi kailanman tumutugma ang may quotes at bawat request ay nakakakuha ng 401.
Binibigyan ng easyCoexistence ang bawat account ng isang Partner API key, para maikonekta ng inyong backend ang mga WhatsApp na numero ng mga customer ninyo at ang kanilang Instagram, Facebook, TikTok, YouTube at LinkedIn account, at iba pang channel, saka babasahin ang credentials ng bawat connection at ihahatid ang mga event nito. Mula US$ 9 hanggang US$ 0.75 kada connection kada buwan, bumababa habang dumarami ang connection, na may unang 3 araw na free trial.
Mga madalas itanong
Maaari bang magkaroon ng higit sa isang API key ang isang account?
Hindi. Isang key lang ang hawak ng account sa isang pagkakataon, at ang paggawa ng bago ay pumapalit dito. Ang magkakahiwalay na key ay nangangahulugang magkakahiwalay na easyCoexistence account, bawat isa may sariling connection at sariling bill.
Nag-e-expire ba ang Partner API keys?
Hindi. Gumagana ang key hanggang ma-rotate o ma-revoke, o hanggang tapusin ito ng easyCoexistence dahil sa pag-abuso sa mga patakaran ng Meta.
Kailangan ba ng mga customer ko ang key ko para mag-connect?
Hindi. Binubuksan lang nila ang hosted connect link, na may sariling session id. Nananatili ang key sa inyong server at ginagamit lamang ng inyong backend.
Pareho ba ang API key sa signing secret ng events?
Hindi. Pinatutunayan ng key ang mga request ninyo sa API. Ang signing secret, na ipinapakita nang isang beses kapag nagtakda kayo ng status events URL, ay nagbibigay-daan sa inyong endpoint na i-verify ang mga event na ipinapadala ng easyCoexistence.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong