دليل واجهة برمجة التطبيقات الأساسية لعرض إنستغرام: استرجاع معلومات مستخدم إنستغرام

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

واجهة برمجة تطبيقات إنستغرام Basic Display

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

الإعداد قبل الوصول إلى API

المتطلبات:

1. حساب مطور فيسبوك.

2. حساب تجريبي على إنستغرام.

3. صفحة ويب (عنوان URL) لإعادة التوجيه لمنح الإذن للتطبيق بالوصول إلى إنستغرام.

خطوات الإعداد:

1. في صفحة المطور، انقر على إنشاء تطبيق. اختر آخر للمتابعة.

2. اختر عميل كنوع تطبيق لواجهة برمجة تطبيقات إنستغرام Basic Display

بعد ذلك، قم بملء معلوماتك (اسم التطبيق، البريد الإلكتروني للتواصل) وتابع

3. قم بتعيين عنوان URL للمنصة. انتقل إلى الإعدادات > الأساسية، انقر على إضافة منصة في الأسفل وأدخل عنوان URL الخاص بك (الصفحة المذكورة في المتطلبات).

4. إعداد واجهة برمجة تطبيقات إنستغرام Basic على لوحة التحكم

بعد إنشاء التطبيق، ستظهر نموذج مع بعض الأشياء التي يجب حفظها وملؤها.

مطلوب معرف التطبيق والسر في وقت لاحق.

5. أدخل نفس عنوان URL السابق في Valid OAuth redirect URI, Deauthorization callback URL وطلب حذف البيانات نظرًا لأن هذا التطبيق للاختبار.

أضف المختبر إلى النموذج، على سبيل المثال، إذا أرادت أليس استرجاع معلومات بوب، أدخل اسم مستخدم حساب بوب.

بعد إضافة مستخدم، ستبقى حالة المستخدم معلقة حيث تحتاج إلى إذن من المستخدم. يُنصح باستخدام حساب المختبر.

6. قم بتسجيل الدخول إلى حساب إنستغرام التجريبي الخاص بك، انتقل إلى الإعدادات> إذن الموقع> التطبيقات والمواقع> دعوات المختبر. قبول دعوة الاختبار.

تم إعداد الأساسيات!

كيف تطلب الإذن؟

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

https://api.instagram.com/oauth/authorize?client_id={app-id}&redirect_uri={redirect-uri}
&scope=user_profile,user_media
&response_type=code

تفسير للسمات:

App-id: معرف التطبيق هو المعرف، يمكن العثور عليه في العرض الأساسي تحت تطبيق إنستغرام Basic Display.

redirect_uri: نفس عنوان URL كـ valid OAuth redirect URI.

تذكر عدم ترك مسافة لكامل عنوان URL.

بعد النقر على إدخال، سينتقل إلى الصفحة للسماح بالإذن.

بعد السماح بالوصول الكامل، سيتم إعادة التوجيه إلى عنوان URL الخاص بك، مع إرفاق معلمة الرمز بالعنوان، يبدو كالتالي

https://www.example.com/?code=ABCD......#_

الرمز المصرح به هو ما بعد code=، تذكر حذف #_ نظرًا لأنه ليس جزءًا من الرمز المصرح به.

كيف تستخدم Apidog لاستخدام تبادل الرمز إلى رمز وصول؟

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

تحويل الرمز المصرح به إلى رمز وصول

قم بتغيير الطريقة إلى POST، أدخل عنوان URL:

https://api.instagram.com/oauth/access_token

أضف هذه المعلمات المطلوبة:

• client_id = معرف تطبيق إنستغرام
• client_secret = السر لتطبيق إنستغرام
• code = الرمز المصرح به الذي تم الحصول عليه
• grant_type = authorization_code (هذه القيمة محددة)
• redirect_uri = URI الخاص بك

انقر على إرسال، وسيتم إرجاع رمز الوصول في شكل ملف JSON، يبدو كالتالي:

{
"access_token": "IGQWR9......",
"user_id": 7666070400110123
}

ملاحظة: الرمز صالح أيضًا لمدة ساعة واحدة

كيف تستخدم رمز الوصول ومعرف المستخدم لاستعلام معلومات الحساب؟

هناك مجموعة من الميزات التي يمكن استرجاعها باستخدام واجهة برمجة تطبيقات عرض إنستغرام الأساسية، فيما يلي مثالان لاسترجاع المعلومات.

1. الوصول إلى المعلومات الأساسية لحساب

طلب عينة باستخدام curl:

curl -X GET \  'https://graph.instagram.com/{user-id}?fields=id,username&access_token={access-token}'

تفسير المعلمات:

• User_id: يتم الحصول عليه من الخطوة السابقة
• Access_token: من الخطوة السابقة
• Fields: يمكن أن تكون جزئيًا اختيارية. هناك 4 أنواع من الحقول المتاحة:

1. نوع الحساب: نوع الحساب 
2. معرف: user_id 
3. عدد الوسائط: عدد المنشورات
4. اسم المستخدم: اسم الحساب

إذا كنت ترغب في الحصول على كل هذه الأربعة، أدخلها جميعًا مفصولة بفواصل (,)

نتيجة الإرجاع:

2. استرجاع معلومات منشورات المستخدم

طلب عينة:

curl -X GET \ 
'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

الإعداد في Apidog:

للحصول على المزيد من الميزات مع واجهة برمجة تطبيقات عرض إنستغرام، يرجى الاطلاع على:

الخلاصة

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