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

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

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

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

القيود

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

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

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

يجب أن يتم تقديم الطلب من جانب الخادم وأن يحتوي على:

رمز وصول مستخدم Threads صالح (غير منتهي الصلاحية) قصير الأجل.
المفتاح السري لتطبيق Threads (لوحة معلومات التطبيق > إعدادات التطبيق > الإعدادات الأساسية > المفتاح السري لتطبيق Threads).

المعلمات

يمكن تضمين معلمات سلسلة الاستعلام التالية لدعم الطلب.

الاسم	الوصف
`client_secret` string (سلسلة)	مطلوب. المفتاح السري لتطبيق Threads، الذي يتم عرضه في لوحة معلومات التطبيق > إعدادات التطبيق > الإعدادات الأساسية > حقل المفتاح السري لتطبيق Threads.
`grant_type` string (سلسلة)	مطلوب. قم بتعيين هذه على `th_exchange_token`.
`access_token` string (سلسلة)	مطلوب. رمز وصول مستخدم Threads قصير الأجل (غير منتهي الصلاحية) الذي تريد استبداله برمز طويل الأجل.

عينة من الطلب

curl -i -X GET "https://graph.threads.net/access_token
  ?grant_type=th_exchange_token
  &client_secret=<THREADS_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 لتحديث رموز وصول مستخدم Threads طويلة الأجل التي لم تنته صلاحيتها. ويؤدي تحديث رمز الوصول طويل الأجل إلى أن يكون صالحًا لمدة 60 يومًا مرة أخرى. وستنتهي صلاحية رموز الوصول طويلة الأجل التي لم يتم تحديثها خلال 60 يومًا.

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

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

المعلمات

الاسم	الوصف
`grant_type` string (سلسلة)	مطلوب. قم بتعيين هذه على `th_refresh_token`.
`access_token` string (سلسلة)	مطلوب. رمز وصول مستخدم Threads طويل الأجل (غير منتهي الصلاحية) الذي تريد تحديثه.

عينة من الطلب

curl -i -X GET "https://graph.threads.net/refresh_access_token
  ?grant_type=th_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
}