نظرة سريعة#
يحمل كل طلب مفتاح تطبيقك في ترويسة api360key. لا جلسات ولا ملفات تعريف ارتباط. أما التطبيق المضبوط على HTTP Basic فيرسل اسم المستخدم وكلمة المرور في ترويسة Authorization القياسية بدلاً من ذلك.
api360key: REPLACE_WITH_YOUR_KEY
الترويسات#
| الترويسة | القيمة | متى |
|---|---|---|
api360key | مفتاح تطبيقك | مع كل طلب |
Authorization | Basic ثم ترميز base64 لـ username:password | فقط للتطبيقات المضبوطة على HTTP Basic |
Content-Type | application/json | مع كل طلب له جسم |
الطرق#
| الطريقة | متى تُستخدم | ملاحظة |
|---|---|---|
| مفتاح API | الافتراضية | الأبسط، وتكفي أكثر الحالات |
| HTTP Basic | بديلة | اسم مستخدم وكلمة مرور مولَّدان للتطبيق، يُرسلان في ترويسة Authorization |
ينتمي المفتاح أو بيانات اعتماد Basic إلى تطبيق واحد، وينتمي التطبيق إلى بيئة واحدة. وبيانات الاعتماد الخاطئة أو الغائبة تلقى الرد 403 نفسه الذي يلقاه غياب الاشتراك: No active subscription for this product.
المفتاح سرٌّ من جهة الخادم#
لا تضع مفتاحاً في متصفّح ولا في تطبيق جوّال ولا في مستودع عام. وإن كان لا بد أن يبدأ الاستدعاء من الواجهة الأمامية، فمرّره عبر خادمك. ولاستبدال مفتاح بلا انقطاع، راجع التطبيقات والمفاتيح.
مخطّط له
بيانات اعتماد العميل في OAuth 2.0 مع رموز محدودة النطاق، وTLS المتبادل، طريقتين إضافيتين لمصادقة التطبيق.
انظر أيضاً#
آخر تحديث 2026-10-17