كيف أستخدم System API لإضافة موظف Mr. AI إلى تطبيقي؟
أنشئ مفتاحًا باسم واضح من صفحة System API، وانسخه عند ظهوره أول مرة، ثم أرسل طلب POST إلى /api/v1/chat باستخدام Bearer token ومعرف ثابت للمستخدم والرسالة. المفاتيح مخصصة للمحادثة ولا تكشف مفتاح النظام الداخلي.
- المفتاح السري يظهر مرة واحدة فقط.
- استخدم user_id ثابتًا لكل عميل للحفاظ على سياق صحيح.
- ألغ المفتاح فور الاشتباه في تسريبه.
خطوات الاستخدام
- 1
افتح Settings ثم Connect ثم API.
- 2
اكتب اسم المفتاح وأنشئه ثم انسخ القيمة السرية فورًا.
- 3
احفظ المفتاح في Secret Manager أو متغير بيئة على السيرفر.
- 4
أرسل POST إلى /api/v1/chat مع Authorization: Bearer والمحتوى JSON.
- 5
راجع آخر استخدام وألغ أي مفتاح لم يعد مستخدمًا.
أسئلة شائعة
هل أضع المفتاح داخل تطبيق المتصفح أو الموبايل؟
لا يُفضّل؛ مرّر الطلب عبر Backend تملكه حتى لا يتعرض المفتاح للمستخدم.
هل يمكن رؤية المفتاح مرة أخرى؟
لا، تظهر القيمة الكاملة عند الإنشاء فقط؛ أنشئ مفتاحًا جديدًا إذا فقدتها.