الأمان
دليل مفاتيح API لـ ChefSphere: X-API-Key والنطاقات والمشاريع
تعلّم كيف ستعمل مفاتيح ChefSphere: مفتاح مشروع وترويسة X-API-Key ونطاقات وخصم لكل نداء. وصول مبكر — ب.

نموذج بأسلوب Firebase: المفتاح هو المشروع
في منصة Developers يعرّف مفتاح API المشروع. ترسل X-API-Key في كل نداء؛ يحلّ ChefSphere المسار ويتحقق من النطاقات ويخصم رموزًا مسبقة الدفع. مستخدمو تطبيقك النهائيون ليسوا وحدة فوترة المنصة.
تُصدر المفاتيح عندما يفعّل انضمام الوصول المبكر حسابك. يهيّئ هذا الدليل النموذج الذهني والأمني.
النطاقات ومبدأ أقل امتياز
تحمل المفاتيح نطاقات متوافقة مع الوحدات/العمليات. مفتاح كتالوج فقط لا ينبغي أن ينفّذ KYC. عند وجود المفاتيح دوّرها وافصل البيئات (مثل التطوير مقابل الإنتاج) حسب الممارسات التي نبلّغها في الانضمام.
لا تضمّن المفاتيح في تطبيقات الجوال بلا وكيل خادم إن كان الإساءة تقلقك: عامل المفتاح كسر خادم.
القياس لكل نداء
لكل مسار محلول تكلفة بالرموز. لا تصمّم فشل المصادقة كـ «مجاني لاستكشاف الإنتاج»: استخدم العيّنات والبيئات التي نشير إليها عند منحك الوصول. اقرأ prepaid-api-tokens وmulti-module-token-billing.
يُظهر التوثيق العام OpenAPI بعيّنات بمسارات وهمية /v1/sample — ليست مفاتيح ولا مضيفات نهائية.
ماذا تفعل اليوم
اطلب وصولًا مبكرًا واذكر الوحدات وما إن احتجت عدة مشاريع/بيئات. نراسل عبر البريد عند فتح إصدار المفاتيح — بلا لوحة زائفة.
ذات صلة: prepaid-api-tokens وmulti-module-token-billing وdeveloper-early-access.
مفاتيح API — نقاط أساسية
مشروع + X-API-Key + نطاقات + خصم رموز لكل نداء.
- يعرّف المفتاح المشروع لا المستخدم النهائي لتطبيقك.
- نطاقات حسب القدرة؛ دوّر وافصل عند وجود بيئات.
- قياس مسبق الدفع لكل نداء مصادق.
- إصدار المفاتيح فقط بعد الوصول المبكر.
أسئلة شائعة
- هل يمكنني إنشاء مفتاح الآن؟
- لا عبر الخدمة الذاتية. اطلب وصولًا مبكرًا؛ نصدر المفاتيح في الانضمام.
- هل يستبدل OAuth المستخدم النهائي مفتاح API؟
- قد يملك تطبيقك مصادقة مستخدمين خاصة. تُصادق نداءات ChefSphere Developers بمفتاح المشروع لفوترة/نطاقات المنصة.
- أي ترويسة أستخدم؟
- النموذج الموثّق في هندسة المنصة هو X-API-Key (بأسلوب Firebase). تأكيد التسمية الدقيقة في توثيق الانضمام.
- هل توجد مفاتيح للقراءة فقط؟
- التصميم يتأمل النطاقات. الدقة تُؤكَّد عند إصدار المفاتيح.