تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

مصادقة Partner API: مفاتيح Bearer ec_live_ والتدوير وأخطاء 401

يحمل كل طلب إلى Partner API (واجهة برمجة التطبيقات الخاصة بالشركاء) المفتاح السري للحساب في الترويسة Authorization: Bearer ec_live_…، ويُرسَل من خادمك. لكل حساب في easyCoexistence مفتاح واحد يُنشأ من لوحة التحكم ضمن الملف الشخصي ثم المطورون، أو بطلب من مساعد ذكي تشغيل create_api_key، ويُعرض مرة واحدة فقط. يُصدر التدوير مفتاحًا جديدًا ويُلغي القديم فورًا، ويُعاد خطأ 401 ذو الرمز unauthorized للطلب الذي لا يحمل مفتاحًا صحيحًا.

ec_live_

البادئة التي يبدأ بها كل مفتاح Partner API، ويُرسَل مع كل طلب بصيغة Bearer داخل ترويسة Authorization، وهي الصيغة المعتمدة.

1 key

عدد المفاتيح التي يحملها الحساب في الوقت نفسه؛ وكل اتصال يُنشأ بها يتبع ذلك الحساب.

401

الحالة الخاصة بالمفتاح المفقود أو غير الصالح، برمز الخطأ unauthorized ورسالة تذكر الترويسة المتوقعة.

Once

عدد المرات التي يُعرض فيها المفتاح كاملًا، عند إنشائه أو تدويره؛ وبعد ذلك لا يظهر إلا أول أحرف منه.

كيف تُصادَق الطلبات؟

بالمفتاح كرمز Bearer في ترويسة Authorization لكل طلب يُرسَل إلى https://easycoexistence.com/api/v1. لا يُوقَّع شيء آخر ولا يُحدَّد نطاق آخر: المفتاح يُعرّف الحساب، وكل ما ينشئه الطلب أو يقرؤه يعود إلى ذلك الحساب. الأجسام بصيغة JSON، وتأتي كل الأخطاء ككائنات فيها الحقلان code وmessage بالتتابع.

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

أين تنشئ المفتاح؟

من لوحة التحكم أو من مساعد ذكي، والنتيجة واحدة. في لوحة التحكم افتح الملف الشخصي ثم المطورون، واضغط إنشاء مفتاح API. في Claude أو ChatGPT أو أي مساعد آخر متصل بخادم MCP الخاص بـ easyCoexistence، اطلب منه إعداد Partner API: يعرض get_partner_setup ما ينقص، ويُعيد create_api_key المفتاح. وفي الحالتين يظهر المفتاح كاملًا مرة واحدة، فخزّنه في أسرار خادمك الخلفي فورًا.

لماذا يُعرض المفتاح مرة واحدة فقط؟

لأنه لا يُخزَّن منه إلا تجزئة (hash). تحتفظ easyCoexistence بالتجزئة للتحقق من كل طلب، وبأول أحرف المفتاح، أي ec_live_ وستة أحرف أخرى، كي تُظهر لوحة التحكم المفتاح النشط ووقت إنشائه. المفتاح المفقود لا يمكن عرضه من جديد؛ والتدوير يستبدله.

كيف تدوِّر المفتاح أو تُلغيه؟

بخطوة واحدة، ويتوقف المفتاح القديم عن العمل في تلك اللحظة دون فترة سماح، لأن التسريب هو السبب المعتاد للتدوير. يُعرض المفتاح الجديد مرة واحدة كما في المرة الأولى:

  • لوحة التحكم: الملف الشخصي، ثم المطورون، ثم تدوير المفتاح.
  • MCP: create_api_key مع replace_existing بقيمة true. ومن دونه ترفض الأداة ما دام مفتاح موجود، فلا يتعطل تكامل يعمل دون قصد.
  • لإيقاف كل الوصول بدلًا من ذلك، ألغِ المفتاح: الإلغاء من لوحة التحكم، أو revoke_api_key مع confirm بقيمة true. بعدها تفشل الطلبات حتى يُنشأ مفتاح جديد.

ماذا يُرجع المفتاح المفقود أو الخاطئ؟

يُرجع الخطأ 401 مع الرمز unauthorized، لطلب بلا ترويسة Authorization، أو بمفتاح لا يبدأ بـ ec_live_، أو بمفتاح دُوِّر أو أُلغي. تذكر الرسالة الترويسة المتوقعة. وإذا توالت الطلبات الفاشلة من عنوان واحد، يُجيب الـ API بالخطأ 429 rate_limited بدلًا من ذلك، مع عدد الثواني المطلوب انتظارها قبل المحاولة من جديد.

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

ما الذي قد يُرفض مع مفتاح صالح؟

المفتاح الصالح يُثبت هوية الحساب، وتظل حالة الحساب سارية. وتعود هذه الأخطاء بالشكل نفسه:

  • 402 billing_required: لا توجد بطاقة على الحساب بعد، لذا لا يمكن بدء جلسات الربط.
  • 404 not_found: المعرّف لا ينتمي إلى أي اتصال أو قناة أو جلسة في هذا الحساب، بما في ذلك ما يخص حسابات أخرى.
  • 409 removed: أُزيل الاتصال، فلا يمكن تغيير خطاف الويب (webhook) الخاص به.
  • 402 suspended: الاتصال موقوف بعد انتهاء الاشتراك؛ أعد ربطه أولًا.
  • 429 cap_reached أو rate_limited: جلسات ربط مفتوحة كثيرة، أو جلسات كثيرة أُنشئت خلال الساعة.

الأخطاء الشائعة

  • وضع المفتاح في كود الواجهة الأمامية. أي شخص يفتح الصفحة يستطيع قراءته، وينشئ اتصالات تُحاسَب عليك، ويستطيع جلب رموز عملائك عبر ?credentials=1 في الرابط نفسه.
  • تدوير المفتاح قبل أن يستطيع خادمك الخلفي استلام المفتاح الجديد. يتوقف القديم فورًا، فتفشل كل الطلبات بالخطأ 401 حتى يُنشر المفتاح الجديد.
  • إنشاء المفتاح داخل محادثة تشاركها. يُعيد create_api_key المفتاح في الدردشة، حيث يبقى في السجل، لذا دوِّره إن شُورِكت تلك المحادثة.
  • تخزين المفتاح بين علامتي اقتباس. كل ما يلي Bearer يُقرأ مفتاحًا، فالقيمة المحاطة بالاقتباس لا تطابق أبدًا، فتحصل كل الطلبات على 401.
إنجاز ذلك باستخدام EasyCoexistence

تمنح easyCoexistence كل حساب مفتاح Partner API واحدًا، فيستطيع خادمك ربط أرقام WhatsApp لعملائك وحسابات Instagram وFacebook وTikTok وYouTube وLinkedIn، وقنوات أخرى، ثم قراءة بيانات اعتماد كل اتصال وتوجيه أحداثه. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

هل يمكن أن يكون لحساب أكثر من مفتاح API؟

لا. للحساب مفتاح واحد في كل مرة، وإنشاء مفتاح جديد يستبدل الحالي. المفاتيح المنفصلة تعني حسابات منفصلة في easyCoexistence، لكل منها اتصالاته وفاتورته الخاصة.

هل تنتهي صلاحية مفاتيح Partner API؟

لا. يبقى المفتاح صالحًا حتى يُدوَّر أو يُلغى، أو حتى تُنهيه easyCoexistence إن أُسيء استخدام منصة Meta.

هل يحتاج عملائي إلى مفتاحي كي يربطوا حساباتهم؟

لا. يكفيهم فتح رابط الربط المستضاف، وهو يحمل معرّف جلسة خاصًا به. يبقى المفتاح على خادمك، ويستخدمه خادمك الخلفي وحده.

هل مفتاح API هو نفسه سر توقيع الأحداث؟

لا. المفتاح يُثبت طلباتك إلى الواجهة. أما سر التوقيع، الذي يُعرض مرة واحدة عند ضبط عنوان أحداث الحالة، فيتيح لنقطة النهاية (endpoint) لديك التحقق من أحداث easyCoexistence المرسلة إليها.

تابع القراءة

كيف تتيح لعملائك ربط حسابات WhatsApp وInstagram وTikTok بتطبيقكروابط اتصال مستضافة لأرقام WhatsApp وحسابات التواصل لعملائك: طلب الجلسة، إعادة التوجيه، الحالة، الانتهاء وإعادة المحاولة.تسعير واجهة برمجة التطبيقات (API) الموحدة لمنصات SaaS: US$ 9 إلى US$ 0.75 لكل اتصالكيف تدفع المنصة ثمن قنوات عملائها: US$ 9 إلى US$ 0.75 لكل اتصال، محسوبة لـ 10 و100 و1,000 عميل، مع بقاء رسوم Meta منفصلة.حدود Partner API والقواعد: سياسات Meta و20 رسالة في الثانية وقاعدة الـ14 يومًاقواعد المنصة لقنوات عملائها: سياسات واتساب من Meta، و20 رسالة في الثانية لكل رقم Coexistence، وقاعدة 14 يومًا، وما يُنهي المفتاح.مرجع أدوات MCPتعرّف إلى الأدوات التي يتيحها موصل EasyCoexistence، وهي أكثر من 30 أداة، وما تتطلبه كل أداة، والأدوات التي تتوقف عند تعثر الفوترة.النشر على Instagram وTikTok وFacebook من Python عبر واجهة برمجة تطبيقات واحدة (API)انشر وأجب على التعليقات والرسائل من Python على Instagram وFacebook وTikTok وYouTube وLinkedIn، عبر واجهة كل شبكة الرسمية.النشر على Instagram وTikTok وFacebook من Node.js عبر واجهة برمجة تطبيقات (API) واحدةانشر وجدول وترد على Instagram وFacebook وTikTok وYouTube وLinkedIn من Node.js وTypeScript باستخدام fetch، مع أدوات MCP لوكيلك.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في