الربط والتكاملات
أنشئ مفتاح API
أنشئ مفتاحًا ليتمكّن موقعك أو أي نظام آخر من قراءة البيانات وكتابتها في CompanyFlowHQ.
قبل أن تبدأ
- خطتك تتضمن API (Growth أو Pro أو Social Agency).
كيف يعمل
طريقة العمل، خطوة بخطوة
- أنت → CompanyFlowHQ: إنشاء المفتاح وانسخه مرة واحدة
- أنت → خادمك: ضع المفتاح على خادمك (وليس في صفحة ويب أبدًا)
- خادمك → CompanyFlowHQ: يستدعي API مع Authorization: Bearer cfhq_live_…
- CompanyFlowHQ → خادمك: يرد ببياناتك، وفقط ما يسمح به المفتاح
الخطوات باختصار
الخطوة 1 من 5
اضغط الإعدادات في القائمة، ثم اضغط المطوّرون وAPI في صف الانتقال إلى قسم (أو مرّر لأسفل حتى مربع المطوّرون).
تحت مفاتيح API، املأ الاسم، وضع علامة على ماذا يمكنه أن يفعل؟ واختر تنتهي الصلاحية.
اضغط إنشاء المفتاح.
اضغط نسخ المفتاح واحفظه في مكان آمن. ثم اضغط لقد حفظته — لن تراه مرة أخرى.
أرسله في الترويسة (header): Authorization: Bearer cfhq_live_… (راجع اقرأ دليل API).
شكل الكود
أين تجده: الإعدادات ← المطورون وواجهة API ← إنشاء المفتاحأين تلصقه: إعدادات النظام الآخر، بالشكل “Authorization: Bearer <key>”
ليس هذا: whsec_… — هذا سر توقيع خطاف الويب — يُستخدم للتحقق من الرسائل التي نرسلها إليك.
✅ كيف أعرف أنه نجح؟
- يظهر المفتاح في القائمة بأحرفه الأولى (cfhq_live_ab12…)، ويتحدّث آخر استخدام عند استخدامه.
⚠️ أخطاء شائعة
المشكلةوضعت المفتاح في كود موقع يستطيع أي شخص رؤيته.الحلألغِه الآن، واستخدم المفاتيح على الخوادم فقط — وليس في صفحات الويب العامة أبدًا.
المشكلةخطأ 401 “Send your API key as Authorization: Bearer cfhq_live_…”.الحلتأكد من كتابة الترويسة بشكل صحيح ومن أنك نسخت المفتاح كاملًا.