وثائق Make Agent Fast

بيانات الاعتماد والرموز المميزة

اختر كل بيانات الاعتماد المستخدمة في Make Agent Fast وخزّنها وبدّلها وعالج مشكلاتها.

نظرة سريعة

اختر كل بيانات الاعتماد المستخدمة في Make Agent Fast وخزّنها وبدّلها وعالج مشكلاتها.

مسار طلبات APIمفتاح محدد النطاق ← مورد بإصدار ← استجابة موقّعة

بيانات اعتماد الخادم

تمنح مفاتيح API ورموز OAuth صلاحية الوصول إلى واجهة API العامة.

بيانات اعتماد القنوات

تربط رموز البوتات وأسرار التطبيقات مزوّدي المراسلة الخارجيين.

مفاتيح المزوّدين

تتيح بيانات اعتماد BYOK الدفع لمزوّدي الذكاء الاصطناعي من حسابك الخاص لدى المزوّد.

يستخدم Make Agent Fast عدة أنواع من بيانات الاعتماد، ولا يمكن استبدال بعضها ببعض. قبل نسخ أي قيمة، حدّد الجهة التي أصدرتها، والنظام الذي سيستقبلها، وهل يمكن كشفها بأمان في المتصفح.

خريطة بيانات الاعتماد#

بيانات الاعتماد	مكان الإنشاء	الجهة المستخدِمة	سرّية؟	الصيغة أو القيمة المعتادة
المعرّف المختصر (slug) للموقع المنشور	لوحة تحكم الموقع	أداة تحميل التضمين في الموقع	لا	`my-agent`
مفتاح API الخاص بـ Make Agent Fast	الإعدادات ← المطوّرون	الخادم الخلفي أو الأتمتة لديك	نعم	`maf_live_...`
معرّف عميل OAuth	الإعدادات ← المطوّرون	التطبيق متعدد الحسابات	لا	`maf_app_...`
رمز وصول OAuth	نقطة نهاية رمز OAuth	الخادم الخلفي لتطبيقك	نعم	رمز Bearer، مدة صلاحيته ساعة واحدة
رمز تحديث OAuth	نقطة نهاية رمز OAuth	مخزن الرموز الآمن لديك	نعم	`maf_refresh_...`، يُبدَّل عند كل استخدام
مفتاح API لمزوّد الذكاء الاصطناعي (اختياري، باقة Scale)	OpenRouter (للنص) أو Speko (للصوت)	الخادم الخلفي لـ Make Agent Fast	نعم	`sk-or-...` أو `sk_speko_...`
رمز الموصّل أو سر التطبيق	Telegram أو Meta أو Discord أو Kakao	خدمة الموصّلات في Make Agent Fast	نعم	يختلف حسب المزوّد
سر توقيع الـ webhook	إنشاء نقطة نهاية webhook في واجهة API العامة	مستقبِل الـ webhook لديك	نعم	`whsec_...`

اختيار طريقة التفويض المناسبة#

استخدم مفتاح API الخاص بـ Make Agent Fast لخادم تتحكم فيه وحساب واحد على Make Agent Fast. اختر فقط النطاقات (scopes) التي يحتاجها ذلك الخادم.

استخدم OAuth Authorization Code مع PKCE عندما يربط منتجك حسابات تخص مستخدمين آخرين في Make Agent Fast. تخضع تطبيقات OAuth للمراجعة قبل أن ينجح التفويض في بيئة الإنتاج.

استخدم مفتاح مزوّد الذكاء الاصطناعي فقط عندما تريد أن يستدعي Make Agent Fast ذلك المزوّد عبر حسابك لديه. لا يمنح مفتاح المزوّد صلاحية الوصول إلى واجهة API العامة لـ Make Agent Fast.

استخدم بيانات اعتماد الموصّل فقط في نموذج الموصّل المطابق أو في طلب API الخاص بالموصّل. لا يمكن لرمز بوت Telegram تفويض Discord أو Meta أو طلبات API الخاصة بـ Make Agent Fast.

تخزين الأسرار بأمان#

في بيئة التطوير المحلية، ضع الأسرار في ملف بيئة مستثنى من التتبع أو في بيئة الطرفية لديك:

export MAF_API_KEY="maf_live_..."

عند النشر، استخدم مدير الأسرار المشفّر لدى مزوّد الاستضافة. لا تضع الأسرار في:

عمليات Git commit، أو وصف المشكلات (issues)، أو لقطات الشاشة، أو خصائص التحليلات، أو رسائل الدعم.
المتغيرات NEXT_PUBLIC_* أو VITE_* أو أي متغيرات أخرى تُضمَّن في JavaScript الخاص بالمتصفح.
Webflow أو Framer أو Wix أو Shopify Liquid أو HTML في WordPress أو حزمة تطبيق ويب للجوال.
سلاسل الاستعلام (query strings)، إذ يشيع الاحتفاظ بعناوين URL في سجل المتصفح والوسطاء (proxies) والسجلات.

أجرِ استدعاءات API عبر الخادم الخلفي الموثَّق لديك. يجب أن يستدعي المتصفح خادمك الخلفي، وأن يضيف الخادم الخلفي السر.

const response = await fetch("https://makeagent.fast/api/v1/sites", {
  headers: { Authorization: `Bearer ${process.env.MAF_API_KEY}` },
});

قواعد الأسرار التي تُعرض مرة واحدة#

يجب نسخ مفاتيح API وأسرار توقيع webhook ورموز تحديث OAuth المُصدَرة حديثًا عند عرضها، إذ لا يمكن استرجاع القيمة الكاملة لاحقًا. إذا فُقدت، أنشئ بديلًا بدلًا من أن تطلب من الدعم كشفها.

تُشفَّر بيانات اعتماد مزوّدي الذكاء الاصطناعي والموصّلات قبل تخزينها ولا تُعاد عبر واجهات API الخاصة بالقوائم. قد تعرض لوحة التحكم تسمية أو بادئة أو آخر أربعة أحرف أو حالة التحقق أو وقت آخر استخدام، حتى تتمكن من تمييز بيانات الاعتماد دون كشفها.

قائمة التحقق للتبديل#

أنشئ البديل بالنطاقات أو أذونات المزوّد الدنيا نفسها.
حدّث نشرًا واحدًا أو مستقبِلًا واحدًا في كل مرة.
تحقق من نجاح طلب حقيقي وسجّل قيمة x-request-id الخاصة به.
اسحب بيانات الاعتماد القديمة.
تأكد من أن الطلبات القديمة تفشل بالخطأ 401 invalid_api_key أو ما يعادله لدى المزوّد.

في OAuth، احفظ رمز التحديث الجديد الذي تعيده كل استجابة تحديث قبل التخلص من الرمز السابق. وعند تبديل سر webhook، شغّل نقطتي النهاية القديمة والجديدة بالتوازي إلى أن يستخدم كل منتِج ومستقبِل البديلَ.

إذا انكشف سر#

اسحبه أو بدّله فورًا. لا يكفي حذفه من أحدث Git commit، فقد يبقى في السجل التاريخي أو الذاكرة المؤقتة أو السجلات أو النسخ المتفرعة (forks). راجع النشاط في Make Agent Fast وعند المزوّد الذي أصدره، ثم استبدل أي بيانات اعتماد تشترك في موقع التخزين أو بيئة النشر نفسها.

تابع مع المصادقة أو النطاقات والأخطاء أو مفاتيح مزوّدي الذكاء الاصطناعي.