نطاق المفتاح

قيد المشروع

يحصر حقل المشروع (Project) مفتاح API في مشروع معيّن:

• أي (Any) — يصل المفتاح إلى كل مشاريع الحساب
• مشروع معيّن — يعمل المفتاح مع بيانات المشروع المحدد فقط

يتصرف القيد بشكل مختلف حسب الطريقة. في طرق القوائم يعمل كمرشِّح: تنجح الاستجابة لكنها لا تحتوي إلا بيانات المشروع. وفي الطرق التي تخاطب فاتورة أو محفظة بعينها، يرفض الخادم طلب كائن من مشروع آخر بالرد Restricted project.

الطريقة	مفتاح مقيَّد بمشروع
billing/balances	بيانات على مستوى الحساب؛ لا ينطبق القيد
billing/history	عمليات المشروع إضافة إلى العمليات على مستوى الحساب — الإيداعات والمكافآت
billing/tariffs	التعرفة والدوران لمشروع المفتاح فقط
invoices/list	النتائج لمشروع المفتاح فقط
payments/list	النتائج لمشروع المفتاح فقط
statistics/invoices	تُحسب لمشروع المفتاح فقط
statistics/payments	تُحسب على فواتير مشروع المفتاح فقط
invoices/create	يجب أن يطابق projectId في الطلب مشروعَ المفتاح
invoices/cancel	فاتورة مشروع آخر غير قابلة للوصول
invoices/bindPayment	فاتورة مشروع آخر غير قابلة للوصول

قيد النطاق

يحدد النطاق طرق API التي يستطيع المفتاح استخدامها. وهو حقل إلزامي متعدد الاختيار.

يرفض الخادم استدعاء طريقة خارج نطاق المفتاح بالرد Restricted scope.

اجتماع القيود

يعمل قيدا المشروع والنطاق معًا. مثلًا، إذا كان المفتاح محصورًا في طرق الفواتير ومربوطًا بمشروع معيّن:

• لا تتاح إلا طرق الفواتير
• لا تشمل البيانات إلا المشروع المحدد
• يرفض الخادم طلبات الدفعات والإحصاءات
• يرفض الخادم طلبات بيانات المشاريع الأخرى