MasukMulai uji coba gratis
easyCoexistence API resmi

Autentikasi Partner API: kunci Bearer ec_live_, rotasi, dan kesalahan 401

Setiap permintaan Partner API membawa kunci rahasia akun di header Authorization: Bearer ec_live_…, dikirim dari server Anda. Setiap akun easyCoexistence memiliki satu kunci, dibuat di dashboard di bawah Profile, Developers, atau dengan meminta asisten AI menjalankan create_api_key, dan hanya ditampilkan sekali. Rotasi kunci menerbitkan kunci baru dan langsung mengakhiri kunci lama; permintaan tanpa kunci atau dengan kunci yang salah mendapat 401 unauthorized.

ec_live_

Awalan yang dimiliki setiap kunci Partner API, dikirim pada setiap permintaan sebagai Authorization: Bearer.

1 key

Jumlah kunci yang dimiliki akun pada satu waktu; setiap koneksi yang dibuat dengannya menjadi milik akun tersebut.

401

Status untuk kunci yang hilang atau tidak valid, dengan kode kesalahan unauthorized dan pesan yang menyebut header yang diharapkan.

Once

Waktu kunci lengkap ditampilkan, saat dibuat atau dirotasi; setelahnya hanya beberapa karakter pertama yang terlihat.

Bagaimana permintaan diautentikasi?

Dengan kunci sebagai token Bearer di header Authorization pada setiap permintaan ke https://easycoexistence.com/api/v1. Tidak ada yang lain yang ditandatangani atau dibatasi cakupannya: kunci mengidentifikasi akun, dan semua yang dibuat atau dibaca permintaan menjadi milik akun tersebut. Isi permintaan berupa JSON, dan setiap kesalahan dikembalikan sebagai objek dengan kode dan pesan.

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

Di mana kunci dibuat?

Di dashboard atau dari asisten AI, dengan hasil yang sama. Di dashboard, buka Profile, lalu Developers, dan tekan Create API key. Di Claude, ChatGPT, atau asisten lain yang terhubung ke server MCP easyCoexistence, minta asisten menyiapkan Partner API: get_partner_setup menampilkan apa yang masih kurang dan create_api_key mengembalikan kunci. Bagaimanapun caranya, kunci lengkap muncul sekali, jadi simpan segera di penyimpanan rahasia backend Anda.

Mengapa kunci hanya ditampilkan sekali?

Karena hanya hash-nya yang disimpan. easyCoexistence menyimpan hash untuk memeriksa setiap permintaan, ditambah beberapa karakter pertama kunci, yaitu ec_live_ dan enam karakter lagi, agar dashboard bisa menampilkan kunci mana yang aktif dan kapan dibuat. Kunci yang hilang tidak bisa ditampilkan lagi; rotasi menggantinya.

Bagaimana cara merotasi atau mencabut kunci?

Dalam satu langkah, dan kunci lama berhenti berfungsi saat itu juga, tanpa masa tenggang, karena kebocoran adalah alasan umum untuk merotasi. Kunci baru ditampilkan sekali, seperti kunci pertama:

  • Dashboard: Profile, Developers, Rotate key.
  • MCP: create_api_key dengan replace_existing bernilai true. Tanpa itu, alat menolak selama kunci masih ada, sehingga integrasi yang sedang berjalan tidak rusak secara tidak sengaja.
  • Untuk menghentikan semua akses, cabut: Revoke di dashboard, atau revoke_api_key dengan confirm bernilai true. Permintaan kemudian gagal sampai kunci baru dibuat.

Apa yang dikembalikan jika kunci hilang atau salah?

401 dengan kode unauthorized, untuk permintaan tanpa header Authorization, kunci yang tidak diawali ec_live_, atau kunci yang sudah dirotasi atau dicabut. Pesan menyebut header yang diharapkan. Jika permintaan gagal terus berasal dari satu alamat, API menjawab 429 rate_limited, dengan jumlah detik yang harus ditunggu sebelum mencoba kembali.

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

Apa lagi yang bisa ditolak untuk kunci yang valid?

Kunci yang valid mengautentikasi akun, dan kondisi akun tetap berlaku. Respons berikut memakai bentuk kesalahan yang sama:

  • 402 billing_required: belum ada kartu di akun, sehingga sesi koneksi tidak bisa dimulai.
  • 404 not_found: id tidak termasuk koneksi, saluran, atau sesi milik akun ini, termasuk yang ada di akun lain.
  • 409 removed: koneksi sudah dihapus, sehingga webhook-nya tidak bisa berubah.
  • 402 suspended: koneksi ditangguhkan setelah langganan berakhir; sambungkan kembali terlebih dahulu.
  • 429 cap_reached atau rate_limited: terlalu banyak sesi koneksi yang terbuka, atau terlalu banyak dibuat dalam satu jam ini.

Kesalahan umum

  • Menaruh kunci di kode front-end. Siapa pun yang membuka halaman bisa membacanya, membuat koneksi yang ditagih ke Anda, dan mengambil kredensial pelanggan Anda dengan ?credentials=1.
  • Merotasi sebelum backend Anda siap memakai kunci baru. Kunci lama berhenti seketika, sehingga setiap permintaan gagal dengan 401 sampai kunci baru di-deploy.
  • Membuat kunci dalam percakapan yang Anda bagikan. create_api_key mengembalikannya di chat, tempat ia tersimpan dalam riwayat, jadi rotasi kunci jika percakapan itu dibagikan.
  • Menyimpan kunci dengan tanda kutip. Semua yang setelah Bearer dibaca sebagai kunci, sehingga nilai yang dikutip tidak pernah cocok dan setiap permintaan mendapat 401.
Melakukan ini dengan EasyCoexistence

easyCoexistence memberi setiap akun satu kunci Partner API, sehingga backend Anda dapat menghubungkan nomor WhatsApp pelanggan serta akun Instagram, Facebook, TikTok, YouTube, dan LinkedIn mereka, dan saluran lainnya, lalu membaca kredensial setiap koneksi dan mengarahkan event-nya. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah satu akun bisa memiliki lebih dari satu kunci API?

Tidak. Akun hanya memiliki satu kunci pada satu waktu, dan membuat kunci baru menggantikan yang lama. Kunci terpisah berarti akun easyCoexistence terpisah, masing-masing dengan koneksi dan tagihannya sendiri.

Apakah kunci Partner API kedaluwarsa?

Tidak. Kunci berfungsi sampai dirotasi atau dicabut, atau sampai easyCoexistence mengakhirinya karena penyalahgunaan aturan Meta.

Apakah pelanggan saya memerlukan kunci saya untuk terhubung?

Tidak. Mereka hanya membuka tautan koneksi yang dihosting, yang membawa id sesinya sendiri. Kunci tetap di server Anda dan hanya dipakai oleh backend Anda.

Apakah kunci API sama dengan rahasia penandatanganan event?

Tidak. Kunci mengautentikasi permintaan Anda ke API. Rahasia penandatanganan, yang ditampilkan sekali saat Anda mengatur URL event status, memungkinkan endpoint Anda memverifikasi event yang dikirim easyCoexistence.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada