الانتقال إلى المحتوى الرئيسي
صفحة API keys تعرض مفتاحين بالاسم والبادئة فقط، أحدهما بتسمية Sandbox، مع تاريخي الإنشاء وآخر استخدام، وإجراءات Revoke وزر Create key
يتيح مفتاح API لبرامجك النصية وأدوات no-code والخدمات الخلفية استدعاء Flowella REST API لصالح مؤسستك. توضح هذه الصفحة كيفية إنشاء المفاتيح واستخدامها واستبدالها وإلغائها.

​
قبل أن تبدأ

  • تحتاج إلى دور Owner أو Admin. يمكن للأدوار الأخرى رؤية API keys في القائمة، لكن القائمة لا تُحمَّل لهم. راجع الفريق والأدوار.
  • حدّد المكان الذي ستخزن فيه المفتاح، على سبيل المثال مدير أسرار أو مخزن بيانات الاعتماد في أداتك. يعرض Flowella المفتاح الكامل مرة واحدة فقط.
هل تبني تطبيقًا يثبّته عملاء Flowella الآخرون؟ استخدم تطبيق OAuth بدلًا من مفتاح API. راجع تسجيل تطبيق شريك باستخدام OAuth.

​
إنشاء مفتاح API

1

افتح API keys

انتقل إلى Settings، ثم اختر API keys في مجموعة Developer.
2

ابدأ مفتاحًا جديدًا

اختر Create key. يُفتح مربع الحوار Create API key.
3

سمِّ المفتاح

في Name، أدخل ما يدلّك على مكان استخدام المفتاح، على سبيل المثال n8n production. يمكن أن يصل طول الأسماء إلى 120 حرفًا. يعرض Flowella الاسم في هذه القائمة فقط، ولا يُرسل مع طلبات API.
4

اختر مفتاحًا حيًا أو مفتاح sandbox

اترك Sandbox key دون تحديد للحصول على مفتاح حي. حدّده للحصول على مفتاح لا يرسل أي شيء إلى WhatsApp أبدًا. راجع مفاتيح sandbox.
5

أنشئ المفتاح وانسخه

اختر Create. يعرض مربع الحوار Save your API key المفتاح الكامل. اختر Copy، وخزّن المفتاح، ثم اختر Done.
يعرض Flowella المفتاح الكامل مرة واحدة فقط ولا يمكنه عرضه مرة أخرى. إذا فقدته، فألغِ المفتاح وأنشئ مفتاحًا جديدًا. تعامل مع المفاتيح ككلمات المرور: لا تضفها أبدًا إلى نظام التحكم في الإصدارات ولا تلصقها في المحادثات أو المستندات المشتركة.

​
ما يمكن للمفتاح فعله

لا يمكنك قصر مفتاح على بعض النطاقات في التطبيق. إذا كان ينبغي أن يحصل تكامل ما على وصول أضيق، فسجّل تطبيق OAuth يحتوي فقط على النطاقات التي يحتاجها.

​
استخدام المفتاح

أرسل المفتاح كـ bearer token في ترويسة Authorization لكل طلب. للتحقق من أن المفتاح يعمل، استدعِ نقطة النهاية ping:
تعني الاستجابة 200 مع "ok": true أن المفتاح صالح. اختر View API docs في أعلى الشاشة لفتح مرجع API التفاعلي، حيث يمكنك لصق المفتاح وتجربة الطلبات.

​
مفاتيح sandbox

يتيح لك مفتاح sandbox اختبار تكامل دون إرسال أي شيء إلى WhatsApp. تتصرف الطلبات المُجراة بمفتاح sandbox على النحو التالي:
  • يخزّن POST /v1/messages الرسالة في Flowella ويُرجع "sandbox": true مع تعيين metaMessageId على null. لا يصل أي شيء إلى WhatsApp.
  • يعتمد إرسال القالب القالب فورًا، أو يرفضه إذا كان اسم القالب يحتوي على reject_. لا تراه Meta أبدًا.
  • يتم تخطي عمليات الإرسال التجريبية للقوالب.
لا يمنع مفتاح sandbox عمليات الإرسال المجمّع عبر POST /v1/templates/send. تُرسل تلك الرسائل فعليًا. لاختبار الإرسال المجمّع بأمان، شغّل API sandbox على مستوى المؤسسة في مركز المطورين بدلًا من ذلك. أثناء تشغيله، يتم أيضًا تخطي عمليات الإرسال المجمّع من التطبيق.
تعمل مفاتيح sandbox على مؤسستك الحقيقية. تُخزَّن جهات الاتصال والمحادثات والرسائل التي تنشئها مثل أي بيانات أخرى وتظهر في التطبيق. تعرض مفاتيح sandbox شارة Sandbox بجوار اسمها في القائمة.

​
قائمة مفاتيح API

لمعرفة الاستدعاءات التي أجراها مفتاح مؤخرًا، افتح Recent API requests في مركز المطورين.

​
إلغاء مفتاح

  1. في القائمة، اختر Revoke في صف المفتاح.
  2. أكّد المطالبة Revoke this API key? It will stop working immediately.
من ذلك الحين، تفشل الطلبات التي تستخدم المفتاح مع 401 والرسالة Invalid or expired API key. يبقى الصف في القائمة مع شارة Revoked. لا يمكنك التراجع عن الإلغاء: أنشئ مفتاحًا جديدًا إذا احتجت إلى الوصول مرة أخرى.

​
استبدال مفتاح

لا يوجد زر للتدوير. لاستبدال مفتاح دون توقف الخدمة:
  1. أنشئ مفتاحًا جديدًا باسم واضح، على سبيل المثال n8n production 2026.
  2. حدّث تكاملك لاستخدام المفتاح الجديد.
  3. تحقق من تغيّر وقت Last used للمفتاح الجديد.
  4. ألغِ المفتاح القديم.

​
استكشاف الأخطاء وإصلاحها

لا يستطيع عرض مفاتيح API وإدارتها إلا أصحاب دور Owner وAdmin. اطلب من صاحب دور Owner أو Admin إنشاء المفتاح لك. لا يمكن تغيير الأدوار في التطبيق: راجع تغيير دور شخص ما.
تحقق من أن الترويسة هي بالضبط Authorization: Bearer متبوعة بالمفتاح الكامل، دون مسافات أو فواصل أسطر داخل المفتاح. تعني الرسالة Invalid or expired API key أن المفتاح أُلغي أو كُتب بشكل خاطئ. وتعني Missing bearer token أن الترويسة لم تصل: تُسقطها بعض عملاء HTTP عند اتباع إعادة توجيه، لذا استدعِ https://api.flowella.io/v1 مباشرةً.
ألغِه فورًا، ثم أنشئ بديلًا وحدّث تكاملك. تحقق من Recent API requests في مركز المطورين بحثًا عن استدعاءات لا تتعرّف عليها.

​
ذات صلة

مقدمة API

المصادقة والنطاقات وحدود المعدل والأخطاء.

مركز المطورين

طلبات API الأخيرة وبيئة API التجريبية وأدلة البدء السريع.

تطبيقات المطورين

استخدم OAuth عندما تثبّت مؤسسات أخرى تطبيقك.

Webhooks

استقبل الأحداث بدلًا من الاستعلام الدوري من API.
آخر تعديل في ٢٤ أكتوبر ٢٠٢٦