Skip to main content

مفتاح API

للمصادقة، يجب تضمين رأس pubrio-api-key. ينبغي أن يحتوي هذا الرأس على مفتاح API الخاص بك، على سبيل المثال a1b2c3d4e5f6g7h8 الذي يمثل مفتاح API الخاص بك.
يلزمك إنشاء مفتاح API للوصول إلى Pubrio API. يمكنك إنشاء مفتاح API من خلال الدخول إلى قسم الإعدادات.
يتضمن مفتاح API بالفعل معلومات مساحة عملك (Profile)، لذا لا تحتاج إلى تمرير profile_id في نص الطلب. لا يزال معامل profile_id مقبولًا للحفاظ على التوافق مع الإصدارات السابقة، إلا أنه لم يعد مطلوبًا.

رؤوس الطلب

بجانب pubrio-api-key، أرسل رأس User-Agent لتحديد هوية العميل الخاص بك.
يُرفض رأس User-Agent المفقود أو العام قبل وصول الطلب إلى API. تُحظر الطلبات التي لا تحمل وكيل مستخدم (user agent) معروفًا عند الحافة (edge)، وتُعاد بالرمز HTTP 403 مع نص عادي بمحتوى error code: 1010 — وهو ليس بصيغة JSON، وليس من ضمن رموز الأخطاء الموثقة. قد يبدو هذا وكأنه فشل في المصادقة، لكنه ليس كذلك: مفتاح API الخاص بك سليم.تتأثر وكلاء المستخدم الافتراضيون لمكتبات HTTP الشائعة — إذ يُحظر urllib الخاص بـ Python (Python-urllib/3.x)، بينما لا يُحظر كل من curl وrequests. إذا واجهت error code: 1010، فحدّد رأس User-Agent صراحةً وأعد المحاولة.