في هذه الصفحة
نظرة سريعة#
يحمل كل طلب إلى منتج بيانات اعتماد التطبيق الذي يرسله، في ترويسة api360key. لا جلسات ولا ملفات تعريف ارتباط. تُنشأ بيانات الاعتماد في علامة تبويب الصلاحيات في التطبيق، وهي من نوعين، وتتبع التطبيق فتتبع بيئته.
api360key: REPLACE_WITH_YOUR_KEY
ترويسة api360key وغيرها#
| الترويسة | القيمة | متى |
|---|---|---|
api360key | مفتاح API للتطبيق | كل طلب يستخدم مفتاح API |
Authorization | Basic وbase64 لـ username:password | مع بيانات اعتماد من نوع Basic auth فقط |
Content-Type | application/json | كل طلب له جسم JSON |
وتقرأ البوابة المفتاح أيضاً من معامل استعلام باسم api360key. وفضّل الترويسة: فعنوان URL يُكتب في سجلات الخوادم وفي سجل التصفح، أما الترويسة فلا.
أنواع بيانات الاعتماد#
| النوع | ما تولّده المنصة | كيف ترسله |
|---|---|---|
| مفتاح API | 64 حرفاً ورقماً عشوائياً، بلا بادئة | ترويسة api360key |
| Basic auth (HTTP Basic) | اسم مستخدم وكلمة مرور من 64 حرفاً | ترويسة Authorization |
يمكن أن يحمل التطبيق عدة بيانات اعتماد من أي النوعين في وقت واحد، ويعمل كلٌّ منها على كل منتج اشترك فيه التطبيق. وليس لبيانات الاعتماد تاريخ انتهاء. تحتفظ المنصة بها وتعرضها من جديد كلما فتحت علامة تبويب الصلاحيات (التطبيقات والمفاتيح).
ما يحصل عليه من لا تُعرف بياناته#
تجيب البوابة بـ 403 وبـ {"message": "No active subscription for this product"} حين لا تستطيع مطابقة استدعاء مع اشتراك. وهذا هو الجواب الذي يعود عند استدعاء بلا بيانات اعتماد، وببيانات لا تعرفها، وببيانات البيئة الأخرى، وببيانات في ترويسة لا تقرؤها البوابة مثل x-api-key أو رمز Bearer. انظر الأخطاء ورموز الحالة وإعادة المحاولة.
المفتاح سرّ يبقى على الخادم#
لا تضع مفتاحاً أبداً في متصفح ولا في تطبيق جوال ولا في مستودع عام. وإن كان لا بد أن يبدأ الاستدعاء من الواجهة الأمامية فأرسله عبر خادمك أنت. ولاستبدال مفتاح بلا انقطاع راجع التطبيقات والمفاتيح. وبيئة التجربة هي المكان الوحيد الذي ترسل فيه المنصة مفتاحاً من متصفح: مفتاحك أنت، من جلستك أنت المسجَّل دخولها.
OAuth 2.0 ببيانات اعتماد العميل (client credentials) مع رموز محدّدة النطاق، وTLS المتبادل: طريقتان إضافيتان لمصادقة التطبيق.