نظرة عامة

تُعد API العرض الأساسي في Instagram بمثابة API تستند إلى HTTP بحيث يمكن للتطبيقات استخدامها للحصول على الملف الشخصي والصور ومقاطع الفيديو والألبومات الخاصة بمستخدم Instagram.

المكونات

عناوين URL الأساسية

• api.instagram.com — الحصول على رموز وصول مستخدم Instagram
• graph.instagram.com — الحصول على الملفات الشخصية والوسائط الخاصة بمستخدم Instagram

الإصدارات

تدعم واجهة برمجة التطبيق (API) بروتوكول تعيين الإصدارات ودورة طرح الإصدارات نفسها، مثل واجهة Graph API من Facebook. يتم طرح الإصدارات الجديدة كل 3 أشهر تقريبًا وسيتوفر كل إصدار لمدة عامين تقريبًا قبل إيقاف الاستخدام.

للاستعلام عن إصدار واجهة عرض أساسي (API) محدد، يمكنك تضمين رقم الإصدار في مسار الاستعلام بعد عنوان URL الأساسي. على سبيل المثال:

https://graph.instagram.com/v11.0/10218560180051171/media

وإذا حذفت رقم الإصدار من طلبك، فسيتم تحليل الطلب إلى الإصدار المحدد في قسم لوحة تحكّم التطبيق > الإعدادات > الإعدادات المُتقدّمة >قسم ترقية إصدار واجهة برمجة التطبيق (API).

نافذة التصريح

تتيح نافذة التصريح لتطبيقك الحصول على رموز التصريح والأذونات من مستخدمي التطبيق. يمكن استبدال رموز التصريح برموز وصول مستخدم Instagram التي يجب تضمينها عند الاستعلام عن الملف الشخصي أو الوسائط الخاصة بمستخدم التطبيق.

لتنفيذ نافذة التصريح، يرجى الرجوع إلى دليل الحصول على رموز الوصول المتوفر لدينا.

رموز التصريح

يمكن استبدال رموز التصريح برموز وصول مستخدم Instagram قصيرة الأجل. وللحصول على رمز تصريح، يمكنك تنفيذ نافذة التصريح في تطبيقك. وبعد أن ينتهي مستخدم التطبيق من مصادقة هويته من خلال النافذة ويمنح تطبيقك أي أذونات يحتاجها، سنعيد توجيه المستخدم إلى تطبيقك وسيتم تضمين رمز تصريح. ويمكنك حينها استخدام واجهة برمجة التطبيق (API) من أجل استبدال الرمز البرمجي برمز وصول مستخدم Instagram قصير الأجل الخاص بمستخدم التطبيق.

تكون رموز التصريح قصيرة الأجل وصالحة لمدة ساعة واحدة فقط.

رموز وصول مستخدم Instagram

تتم معالجة مصادقة واجهة برمجة التطبيق (API) من خلال رموز وصول مستخدم Instagram التي تتوافق مع بروتوكول OAuth 2.0. وتتوفر رموز الوصول على مستوى التطبيق (تكون فريدة للتطبيق وإقران المستخدم) ويمكن أن تكون قصيرة الأجل أو طويلة الأجل. ويجب أن تتضمن طلبات واجهة برمجة التطبيق (API) التي تستعلم عن مستخدمي Instagram أو الوسائط الخاصة بهم رمز وصول مستخدم Instagram.

رموز الوصول قصيرة الأجل

تكون رموز الوصول قصيرة الأجل صالحة لمدة ساعة واحدة، ولكن يمكن استبدالها بالرموز طويلة الأجل. للحصول على رمز وصول قصير الأجل، قم بتنفيذ نافذة التصريح في تطبيقك. وبعد أن ينتهي مستخدم التطبيق من مصادقة هويته من خلال النافذة، سنعيد توجيه المستخدم مرة أخرى إلى تطبيقك وسنقوم بتضمين رمز تصريح يمكنك استبداله حينئذ برمز وصول قصير الأجل.

رموز الوصول طويلة الأجل

يمكن استبدال الرموز قصيرة الأجل التي لم تنته صلاحيتها برموز وصول طويلة الأجل صالحة لمدة 60 يومًا. يمكن تحديث الرموز طويلة الأجل قبل انتهاء صلاحيتها من خلال الاستعلام عن نقطة النهاية GET /refresh_access_token.

الأذونات

يتم التحكّم في تصريح الوصول إلى البيانات بواسطة مستخدمي تطبيقك من خلال استخدام الأذونات المدرجة أدناه. يجب أن يمنح المستخدمون تطبيقك هذه الأذونات من خلال نافذة التصريح قبل أن يتمكّن تطبيقك من الوصول إلى بياناتهم.

• instagram_graph_user_profile — يمكن السماح لتطبيقك بقراءة عقدة المستخدم والتي تمثل مستخدم Instagram وعناصر ربط العقدة.
• instagram_graph_user_media — يسمح لتطبيقك بقراءة عقدة الوسائط والتي تمثل صورة أو فيديو أو ألبوم وعناصر ربط العقدة.

يمكن لمسؤولي الاختبار في Instagram منح تطبيقك هذه الأذونات في أي وقت. حتى يتمكن مستخدمو التطبيق الذين لا يتوفر لديهم دور في تطبيقك من منح التطبيق هذه الأذونات، يجب الموافقة على كل إذن أولاً للوصول المتقدم من خلال عملية مراجعة التطبيقات ويجب أن يكون تطبيقك في وضع النشر.

تكون الأذونات الممنوحة من قبل مستخدمي التطبيق الذين لديهم حسابات عامة صالحة لمدة 90 يومًا. سيؤدي تحديثرمز الوصول طويل الأجل لدى مستخدم التطبيق إلى تمديد منح الإذن لمدة 90 يومًا أخرى إذا كان مستخدم التطبيق الذي منح الرمز المميز لديه حساب عام. ومع ذلك، إذا كان حساب مستخدم التطبيق خاصًا، فلا يمكن تمديد الإذن الممنوح ويجب أن يمنح مستخدم التطبيق الإذن منتهي الصلاحية لتطبيقك مجددًا.

مُختبرو Instagram

لاختبار تطبيقك من خلال مستخدم Instagram، يجب عليك أولًا إرسال دعوة إلى حساب مستخدم على Instagram وقبول الدعوة. ويمكن إرسال الدعوات من قسم الفاحصين في Instagram من خلال لوحة تحكّم التطبيق > الأدوار > لوحة التبويبالأدوار.

يمكن لمستخدم Instagram قبول الدعوات في القسم (أيقونة الملف الشخصي) > تعديل الملف الشخصي > التطبيقات ومواقع الويب > دعوات الفاحصين على موقع ويب Instagram أو تطبيق الهواتف المحمولة بعد تسجيل الدخول إلى حسابه.

الموارد

تتكون البيانات الموجودة في API من مستخدمي Instagram والوسائط الخاصة بهم (الصور ومقاطع الفيديو والألبومات). وتتم حماية جميع البيانات عن طريق الأذونات وحتى يصل تطبيقك إلى بيانات المستخدم، يجب أن يمنح المستخدم الإذن إلى تطبيقك للوصول إليها من خلال نافذة التصريح.

المستخدمون

يتم تمثيل مستخدمي Instagram وملفاتهم الشخصية بواسطة عُقد المستخدم. ولاحظ أن معرفات المستخدمين القديمة لواجهة برمجة التطبيق (API) في Instagram غير متوافقة مع واجهة برمجة التطبيق (API) العرض الأساسي في Instagram.

الوسائط

يتم تمثيل الصور ومقاطع الفيديو والألبومات عن طريق عُقد الوسائط ويتم إنشاؤها لدى المستخدمين من الأفراد.

تقييدات معدلات الاستدعاء

تخضع كل طلبات نقاط النهاية إلى تقييد معدلات الاستدعاء للمنصة الخاصة بواجهة Graph API.

يمكنك عرض الاستهلاك الحالي لعدد استدعاءات تطبيقك في علامة التبويب لوحة تحكّم التطبيق > Instagram >علامة تبويب تقييد معدلات الاستدعاء للعرض الأساسي بعد إضافة منتج Instagram إلى تطبيقك.

أنواع التطبيقات

تكون التطبيقات التي تم تعيينها كتطبيقات أنشطة تجارية غير مدعومة. وإذا كان تطبيقك هو تطبيق أنشطة تجارية، فاستخدم واجهة Instagram Graph API بدلًا من ذلك أو أنشئ تطبيقًا جديدًا غير مخصص للأنشطة التجارية.

مراجعة التطبيقات

يمكن لمسؤولي الاختبار في Instagram منح تطبيقك أذونات Instagram في أي وقت. حتى يتمكن مستخدمو التطبيق الذين لا يتوفر لديهم دور في تطبيقك من منح التطبيق أذونات Instagram، يجب الموافقة على كل إذن أولاً للوصول المتقدم من خلال عملية مراجعة التطبيقات ويجب أن يكون تطبيقك في وضع النشر.

عندما يكتمل تطوير التطبيق وتكون مستعدًا لتبديل تطبيقك إلى وضع النشر، راجع مستندات مراجعة التطبيقات وعينة من المعلومات المقدَّمة والأسباب الشائعة للرفض التي نوفرها للتعرف على عملية مراجعة التطبيقات. وبمجرد أن تصبح على دراية بالعملية، يمكنك طلب اعتماد أذونات العرض الأساسي لواجهة برمجة التطبيق (API) في Instagram من خلال لوحة تحكّم التطبيق > المنتجات > Instagram > علامة التبويبالعرض الأساسي.

إذا كنت تنشئ تطبيقًا بغرض إنشاء رموز الوصول فقط باستخدام أداة إنشاء رمز المستخدم، فلست بحاجة إلى إرسال تطبيقك لإجراء مراجعة التطبيقات. ولا تتطلب أداة إنشاء رمز المستخدم أي أذونات ويمكن استخدامها أثناء وجود تطبيقك في وضع التطوير.

التحقق من النشاط التجاري

عند تعيين تطبيقك إلى وضع التطوير، لن يتمكّن إلا من الوصول إلى البيانات الموجودة في حسابات Instagram الاختبارية. وقبل أن تتمكّن من تبديل تطبيقك إلى وضع البث المباشر والوصول إلى البيانات الموجودة في الحسابات غير الاختبارية، يجب إكمال عملية التحقق من النشاط التجاري أولًا.

طريقة العمل

لاستخدام واجهة برمجة التطبيق (API)، يجب الحصول أولًا على نافذة التصريح وتقديمها إلى مستخدم التطبيق. يقوم مستخدم التطبيق بمصادقة هويته من خلال النافذة ويتم التصريح لتطبيقك بالوصول إلى البيانات عن طريق منح تطبيقك الأذونات المحددة. وبمجرد الانتهاء من المصادقة، تعيد النافذة توجيهك إلى تطبيقك مرة أخرى وتتضمن رمز تصريح. احصل على الرمز واستبدله برمز وصول مستخدم Instagram قصير الأجل. وبمجرد الحصول على رمز قصير الأجل، يمكنك استخدامه للاستعلام عن نقطتي النهاية المستخدم والوسائط لأية بيانات قد سمح المستخدم لتطبيقك بالوصول إليها، أو استبداله برمز طويل الأجل.

الأدوات

أداة إنشاء رمز المستخدم

أداة إنشاء رمز مستخدم Instagram عبارة عن أداة يمكنك استخدامها لإنشاء رموز وصول مستخدم Instagram طويلة الأجل سريعًا لأحد حسابات Instagram العامة لديك. تكون هذه الأداة مفيدة إذا كنت تختبر تطبيقك ولا تريد أن تهتم بتنفيذ نافذة التصريح أو إذا كنت تستخدم رمزًا قابلًا للنسخ واللصق توفره خدمة تابعة لجهة خارجية (على سبيل المثال، لعرض بيانات Instagram على موقع الويب لديك).

تعمل الأداة عن طريق تشغيل نافذة التصريح التي يمكنك تسجيل الدخول إليها باستخدام حساب Instagram عام قمت بتخصيصه باعتباره حسابًا اختباريًا. وبعد تسجيل الدخول، ستنشئ الأداة رمز وصول طويل الأجل يمكنك نسخه ولصقه. يُرجى العلم أنه لا يمكن إنشاء الرموز إلا لحسابات Instagram العامة.

يمكنك الوصول إلى أداة إنشاء الرمز في علامة التبويب لوحة تحكّم التطبيق > المنتجات > Instagram >علامة التبويب العرض الأساسي.

إذا كنت تنشئ تطبيقًا لغرض إنشاء رموز الوصول فقط باستخدام أداة إنشاء رمز المستخدم، فلست بحاجة إلى إرسال تطبيقك لإجراء مراجعة التطبيقات. لا تتطلب أداة إنشاء رمز المستخدم أي أذونات ويمكن استخدامها أثناء وجود تطبيقك في وضع التطوير.

الخطوات التالية

اتبع دليل بدء الاستخدام للتعرف على كيفية إعداد أي تطبيق وإجراء طلب واجهة برمجة تطبيق (API) أساسي.