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

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

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

التقييدات

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

الحصول على رمز طويل الأجل

استخدم نقطة النهاية GET /access_token لاستبدال رمز وصول مستخدم Instagram قصير الأجل برمز طويل الأجل. وبمجرد الحصول على رمز طويل الأجل، يمكنك استخدامه في إجراء الطلبات من جانب الخادم أو إرساله إلى العميل لاستخدامه بها.

يجب إجراء طلبك من جانب الخادم وأن يتضمن:

• رمز وصول مستخدم Instagram قصير الأجل صالحًا (غير منتهي الصلاحية)
• المفتاح السري لتطبيقك في Instagram (لوحة معلومات التطبيق > المنتجات > Instagram > العرض الأساسي > المفتاح السري لتطبيق Instagram)

لمزيد من المعلومات، يُرجى الرجوع إلى مرجع GET /access_token.

عينة من الطلبات

curl -i -X GET "https://graph.instagram.com/access_token
  ?grant_type=ig_exchange_token
  &client_secret={instagram-app-secret}
  &access_token={short-lived-access-token}"

عينة من الاستجابة

{
  "access_token":"{long-lived-user-access-token}",
  "token_type": "bearer",
  "expires_in": 5183944  // Number of seconds until token expires
}

تحديث رمز طويل الأجل

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

يجب أن يتضمن طلبك:

• رمز وصول مستخدم Instagram طويل الأجل صالحًا (غير منتهي الصلاحية)

لمزيد من المعلومات، يرجى الرجوع إلى مرجع GET /refresh_access_token.

عينة من الطلبات

curl -i -X GET "https://graph.instagram.com/refresh_access_token
  ?grant_type=ig_refresh_token
  &access_token={long-lived-access-token}"

عينة من الاستجابة

{
  "access_token":"{long-lived-user-access-token}",
  "token_type": "bearer",
  "expires_in": 5183944 // Number of seconds until token expires
}