Partner API kimlik doğrulama: Bearer ec_live_ anahtarları, döndürme ve 401 hataları
Her Partner API isteği, hesabın gizli anahtarını Authorization: Bearer ec_live_… başlığında taşır ve bu istek sunucunuzdan gönderilir. Her easyCoexistence hesabının bir anahtarı vardır; panelde Profil, Geliştiriciler altında ya da bir AI asistanından create_api_key çalıştırmasını isteyerek oluşturulur ve yalnızca bir kez gösterilir. Döndürme yeni bir anahtar üretir ve eski anahtarı hemen sonlandırır; eksik ya da hatalı anahtar 401 unauthorized hatası alır.
Her Partner API anahtarının başladığı önek; her istekte Authorization: Bearer ile gönderilir.
Bir hesabın aynı anda tuttuğu anahtar sayısı; bu anahtarla kurulan her bağlantı o hesaba aittir.
Eksik ya da geçersiz anahtarın döndürdüğü durum: hata kodu unauthorized, mesajda beklenen başlığın adı yer alır.
Tam anahtarın gösterildiği tek an: oluşturma ya da döndürme sırasında; sonrasında yalnızca ilk karakterleri görünür.
İstek nasıl kimlik doğrulanır?
https://easycoexistence.com/api/v1 adresine yapılan her isteğin Authorization başlığında, anahtar Bearer token'ı olarak gönderilir. Başka bir imza ya da kapsam tanımı yoktur: anahtar hesabı tanımlar ve bir isteğin oluşturduğu ya da okuduğu her şey o hesaba aittir. Gövdeler JSON'dır ve her hata, bir kod ile bir mesaj içeren bir nesne olarak döner.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Anahtarı nerede oluşturursunuz?
Panelden ya da bir AI asistanından, aynı sonuçla. Panelde Profil'i açın, ardından Geliştiriciler'e geçip API anahtarı oluştur düğmesine basın. easyCoexistence'ın MCP sunucusuna bağlı Claude, ChatGPT ya da başka bir asistandan Partner API'yi kurmasını isteyin: get_partner_setup eksik olanı gösterir, create_api_key anahtarı döndürür. Her iki yolda da tam anahtar yalnızca bir kez görünür; bu yüzden hemen backend'inizin gizli ayarlarına kaydedin.
Anahtar neden yalnızca bir kez gösterilir?
Çünkü yalnızca anahtarın tek yönlü özeti saklanır. Her isteği denetlemek için easyCoexistence bu özeti tutar; ayrıca anahtarın ilk karakterlerini, ec_live_ ve altı karakter daha, saklar ki panel hangi anahtarın canlı olduğunu ve ne zaman oluşturulduğunu gösterebilsin. Kaybedilen bir anahtar yeniden gösterilemez; döndürme onu yenisiyle değiştirir.
Anahtar nasıl döndürülür ya da iptal edilir?
Tek adımda ve eski anahtar o anda çalışmayı durdurur; bekleme süresi yoktur, çünkü döndürmenin genel nedeni sızıntıdır. Yeni anahtar, ilk anahtar gibi yalnızca bir kez gösterilir:
- Panel: Profil, Geliştiriciler, Anahtarı döndür.
- MCP:
create_api_keyçağrısınıreplace_existingdeğeri true ile yapın. Bu olmadan araç, anahtar varken reddeder; böylece çalışan bir entegrasyon kazara bozulmaz. - Tüm erişimi durdurmak için iptal edin: panelde İptal et ya da
revoke_api_keyçağrısını confirm değeri true ile yapın. Yeni bir anahtar oluşturulana kadar istekler başarısız olur.
Eksik ya da hatalı anahtar ne döndürür?
401 ve unauthorized kodu; Authorization başlığı olmayan, ec_live_ ile başlamayan ya da döndürülmüş ya da iptal edilmiş bir anahtarla yapılan istekler için. Mesaj beklenen başlığın adını belirtir. Başarısız istekler tek bir adresten gelmeye devam ederse API bunun yerine 429 rate_limited ile yanıt verir ve yeniden denemeden önce beklenecek saniye sayısını döndürür.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Geçerli bir anahtar hangi durumlarda yine de reddedilir?
Geçerli bir anahtar hesabı doğrular, ama hesabın durumu hâlâ geçerlidir. Bunlar aynı hata şeklinde döner:
- 402
billing_required: hesapta henüz kart yok, bu yüzden bağlantı oturumları başlatamaz. - 404
not_found: bu kimlik bu hesabın hiçbir bağlantısına, kanalına ya da oturumuna ait değil; başka hesaplardakiler de dahil. - 409 removed: bağlantı kaldırıldı, bu yüzden webhook'u artık değiştirilemez.
- 402 suspended: abonelik süresi dolduğu için bağlantı askıya alındı; önce yeniden bağlayın.
- 429
cap_reachedya darate_limited: çok fazla açık bağlantı oturumu ya da bu saat içinde çok fazla oluşturulan oturum var.
Yaygın hatalar
- Anahtarı ön yüz kodunda tutmak. Sayfayı açan herkes okuyabilir; sizin adınıza faturalanan bağlantılar oluşturabilir ve ?credentials=1 ile müşterilerinizin token'larını çekebilir.
- Backend'iniz yeni anahtarı alamadan döndürmek. Eski anahtar hemen durur, bu yüzden yeni anahtar dağıtılana kadar her istek 401 ile başarısız olur.
- Anahtarı paylaştığınız bir sohbette oluşturmak. create_api_key anahtarı sohbette döndürür; sohbet geçmişinde kalır, bu yüzden sohbet paylaşıldıysa anahtarı döndürün.
- Anahtarı tırnak işaretleri arasında saklamak. Bearer'dan sonraki her şey anahtar olarak okunur, bu yüzden tırnaklı değer hiçbir zaman eşleşmez ve her istek 401 alır.
easyCoexistence her hesaba bir Partner API anahtarı verir; böylece backend'iniz müşterilerinizin WhatsApp numaralarını ve Instagram, Facebook, TikTok, YouTube ile LinkedIn hesaplarını, ayrıca diğer kanalları bağlayabilir, her bağlantının kimlik bilgilerini okuyabilir ve olaylarını yönlendirebilir. Bağlantı başına ayda US$ 9'dan başlayarak, bağlantı ekledikçe US$ 0.75'e kadar düşen fiyatla; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Bir hesabın birden fazla Partner API anahtarı olabilir mi?
Hayır. Bir hesabın aynı anda tek bir anahtarı vardır ve yeni bir anahtar oluşturmak mevcut olanın yerine geçer. Ayrı anahtarlar, her biri kendi bağlantıları ve kendi faturası olan ayrı easyCoexistence hesapları demektir.
Partner API anahtarları sona erer mi?
Hayır. Anahtar, döndürülene ya da iptal edilene kadar çalışır; easyCoexistence, Meta'nın kurallarını ihlal ettiği için anahtarı sonlandırana kadar da çalışır.
Müşterilerimin bağlanmak için anahtarıma ihtiyacı var mı?
Hayır. Müşteriler yalnızca kendi oturum kimliğini taşıyan, barındırılan bağlanma bağlantısını açar. Anahtar sunucunuzda kalır ve yalnızca sunucu tarafınız tarafından kullanılır.
API anahtarı, olay imzalama gizli anahtarıyla aynı mı?
Hayır. Anahtar, API'ye yaptığınız istekleri doğrular. İmza gizli anahtarı ise bir durum olayları URL'si ayarladığınızda bir kez gösterilir ve uç noktanızın easyCoexistence'ın gönderdiği olayları doğrulamasını sağlar.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi