Pengesahan Partner API: kunci Bearer ec_live_, pertukaran dan ralat 401
Setiap permintaan Partner API membawa kunci rahsia akaun dalam header Authorization: Bearer ec_live_…, dihantar dari pelayan anda. Setiap akaun easyCoexistence mempunyai satu kunci, dicipta dalam dashboard di bawah Profil, Pembangun, atau dengan meminta pembantu AI menjalankan create_api_key, dan hanya ditunjukkan sekali. Menukar kunci mengeluarkan kunci baharu dan menamatkan yang lama serta-merta; kunci yang tiada atau salah menghasilkan 401 unauthorized.
Awalan yang dimulakan oleh setiap kunci Partner API, dihantar pada setiap permintaan sebagai Authorization: Bearer.
Bilangan kunci yang boleh dimiliki akaun pada satu-satu masa; setiap sambungan yang dibuat dengannya tergolong kepada akaun itu.
Status bagi kunci yang tiada atau tidak sah, dengan kod ralat unauthorized dan mesej yang menyatakan header yang dijangka.
Masa kunci penuh ditunjukkan, iaitu semasa dicipta atau ditukar; selepas itu hanya aksara pertama kelihatan.
Bagaimana permintaan disahkan?
Dengan kunci sebagai token Bearer dalam header Authorization bagi setiap permintaan ke https://easycoexistence.com/api/v1. Tiada apa-apa lagi yang ditandatangani atau dihadkan skopnya: kunci itu mengenal pasti akaun, dan apa sahaja yang dicipta atau dibaca oleh permintaan tergolong kepada akaun tersebut. Badan permintaan ialah JSON, dan setiap ralat dikembalikan sebagai objek dengan medan code dan message.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Di mana kunci dicipta?
Dalam dashboard atau daripada pembantu AI, dengan hasil yang sama. Dalam dashboard, buka Profil, kemudian Pembangun, dan tekan Cipta kunci API. Dalam Claude, ChatGPT atau pembantu lain yang disambungkan kepada pelayan MCP easyCoexistence, minta ia menyediakan Partner API: get_partner_setup menunjukkan apa yang belum ada, dan create_api_key memulangkan kunci. Dalam kedua-dua cara, kunci penuh dipaparkan sekali sahaja, jadi simpannya dalam rahsia pelayan backend anda serta-merta.
Mengapa kunci hanya ditunjukkan sekali?
Kerana hanya cincang kunci disimpan. easyCoexistence menyimpan cincang itu untuk menyemak setiap permintaan, serta aksara pertama kunci, iaitu ec_live_ dan enam lagi, supaya dashboard dapat menunjukkan kunci mana yang aktif dan bila ia dicipta. Kunci yang hilang tidak boleh dipaparkan semula; menukarnya menggantikan kunci tersebut.
Bagaimana kunci ditukar atau dibatalkan?
Dalam satu langkah, dan kunci lama berhenti berfungsi pada saat itu, tanpa tempoh tangguh, kerana kebocoran ialah sebab biasa untuk menukar. Kunci baharu dipaparkan sekali, seperti yang pertama:
- Dashboard: Profil, Pembangun, Tukar kunci.
- MCP:
create_api_keydenganreplace_existingditetapkan kepada true. Tanpanya alat itu menolak selagi kunci wujud, supaya integrasi yang sedang berjalan tidak rosak secara tidak sengaja. - Untuk menghentikan semua akses, batalkan sebaliknya: Batal dalam dashboard, atau
revoke_api_keydengan confirm ditetapkan kepada true. Permintaan kemudian gagal sehingga kunci baharu dicipta.
Apa yang dipulangkan jika kunci tiada atau salah?
401 dengan kod unauthorized, bagi permintaan tanpa header Authorization, kunci yang tidak bermula dengan ec_live_, atau kunci yang telah ditukar atau dibatalkan. Mesejnya menyatakan header yang dijangka. Apabila permintaan gagal terus datang daripada satu alamat, API menjawab 429 rate_limited, dengan bilangan saat untuk menunggu sebelum mencuba semula.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Apa lagi yang boleh menyebabkan kunci sah ditolak?
Kunci sah mengesahkan akaun, dan keadaan akaun masih terpakai. Ini dipulangkan dengan bentuk ralat yang sama:
- 402
billing_required: tiada kad pada akaun lagi, jadi sesi sambungan tidak boleh dimulakan. - 404
not_found: id itu bukan milik mana-mana sambungan, saluran atau sesi akaun ini, termasuk yang berada pada akaun lain. - 409 removed: sambungan telah dibuang, jadi webhooknya tidak boleh diubah.
- 402 suspended: sambungan digantung selepas langganan tamat tempoh; sambung semula dahulu.
- 429
cap_reachedataurate_limited: terlalu banyak sesi sambungan yang terbuka, atau terlalu banyak dicipta dalam jam ini.
Kesilapan biasa
- Meletakkan kunci dalam kod bahagian hadapan. Sesiapa yang membuka halaman boleh membacanya, mencipta sambungan yang dibilkan kepada anda dan mendapatkan token pelanggan anda dengan ?credentials=1.
- Menukar kunci sebelum backend anda boleh menerima kunci baharu. Kunci lama berhenti serta-merta, jadi setiap permintaan gagal dengan 401 sehingga kunci baharu dilancarkan.
- Mencipta kunci dalam perbualan yang dikongsi. create_api_key memulangkannya dalam sembang, di mana ia kekal dalam sejarah, jadi tukar kunci itu jika perbualan tersebut dikongsi.
- Menyimpan kunci dengan tanda petik. Semua selepas Bearer dibaca sebagai kunci, jadi nilai berpetik tidak pernah sepadan dan setiap permintaan mendapat 401.
easyCoexistence memberi setiap akaun satu kunci Partner API, supaya backend anda boleh menyambungkan nombor WhatsApp pelanggan anda serta akaun Instagram, Facebook, TikTok, YouTube dan LinkedIn mereka, dan lebih banyak saluran, kemudian membaca kredensial setiap sambungan dan menghala peristiwanya. Dari US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Bolehkah satu akaun mempunyai lebih daripada satu kunci Partner API?
Tidak. Satu akaun mempunyai satu kunci pada satu-satu masa, dan mencipta yang baharu menggantikan yang lama. Kunci berasingan bermakna akaun easyCoexistence yang berasingan, masing-masing dengan sambungan dan bil sendiri.
Adakah kunci Partner API tamat tempoh?
Tidak. Kunci berfungsi sehingga ia ditukar atau dibatalkan, atau sehingga easyCoexistence menamatkannya kerana menyalahgunakan peraturan Meta.
Adakah pelanggan saya memerlukan kunci saya untuk menyambung?
Tidak. Mereka hanya membuka pautan sambungan yang dihoskan, yang membawa id sesi sendiri. Kunci kekal pada pelayan anda dan hanya digunakan oleh backend anda.
Adakah kunci API sama dengan rahsia tandatangan peristiwa?
Tidak. Kunci mengesahkan permintaan anda ke API. Rahsia tandatangan, yang dipaparkan sekali apabila anda menetapkan URL peristiwa status, membolehkan endpoint anda mengesahkan peristiwa yang dihantar oleh easyCoexistence.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada