خطأ 190 في Instagram: رمز الوصول (token) منتهي الصلاحية أو غير صالح
يعني الخطأ 190 في Instagram أن الـ token المُرسل مع الطلب انتهت صلاحيته، أو أُلغي، أو أصبح غير صالح بطريقة أخرى. مع Instagram Login، يبقى الـ token طويل الأمد صالحًا لمدة 60 يومًا، ويمكن تجديده لمدة 60 يومًا إضافية بعد أن يبلغ عمره 24 ساعة على الأقل. لا يمكن تجديد الـ token الذي انتهت صلاحيته، ويجب أن يسجّل صاحب الحساب الدخول من جديد.
تحافظ easyCoexistence على صلاحية الوصول إلى Instagram: تجدّده قبل انتهائه، وتفحص الحساب كل 6 ساعات، وترسل إليك بريدًا إلكترونيًا عند الحاجة إلى إعادة الربط.
الكود الخاص بانتهاء صلاحية الـ token في واجهة برمجة التطبيقات (API) Graph، وحل Meta له هو الحصول على token جديد.
مدة صلاحية الـ token طويل الأمد لمستخدم Instagram، ومقدار ما يمدّده كل تجديد.
المدة الدنيا التي يجب أن يبلغها الـ token طويل الأمد قبل جواز تجديده، مع بقائه غير منتهٍ.
الكود الفرعي للجلسة التي أُنهيت بتغيير كلمة المرور، وبعدها يلزم الشخص تسجيل الدخول من جديد.
ماذا يعني الخطأ 190 في Instagram بالضبط؟
الـ token المُرسل في الطلب لم يعد مقبولًا. يدرج دليل أخطاء Graph API من Meta الخطأ 190 بوصفه token منتهي الصلاحية، مع حل واحد: الحصول على token جديد. وعندما يصاحبه كود فرعي، يوضح جدول أكواد المصادقة الفرعية في الدليل السبب:
- 463: الـ token منتهي الصلاحية.
- 467: الـ token غير صالح، سواء أكان منتهيًا أم مُلغى أو غير قابل للاستخدام بأي شكل آخر.
- 460: تم تغيير كلمة المرور، وهذا ينهي الجلسة؛ ويلزم الشخص تسجيل الدخول من جديد.
كم مدة صلاحية الـ token في Instagram تحديدًا؟
عند تسجيل الدخول عبر Instagram Login يحصل التطبيق على token قصير الأمد، يبادله من جهة الخادم بـ token طويل الأمد صالح لمدة 60 يومًا. ويمكن تجديد الـ token طويل الأمد لمدة 60 يومًا إضافية بشرط أن يكون عمره 24 ساعة على الأقل، وألا يكون منتهيًا، وأن يكون الشخص قد منح الإذن instagram_business_basic. أما الـ token الذي يمر عليه 60 يومًا دون تجديد فينتهي، ولا يمكن تجديده بعد ذلك.
curl "https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=<LONG_LIVED_TOKEN>"
{
"access_token": "<NEW_LONG_LIVED_TOKEN>",
"token_type": "bearer",
"expires_in": 5183944
}ما الذي يجعل الـ token غير صالح أيضًا؟
انتهاء الصلاحية هو الحالة الشائعة، لكنه ليس الحالة الوحيدة. يؤدي تغيير كلمة المرور إلى إنهاء الجلسة التي يعتمد عليها الـ token، ويُبلَّغ عن ذلك بالكود الفرعي 460، كما يمكن للشخص سحب إذن التطبيق من حسابه، فتفشل الاستدعاءات بعدها حتى يعيد منحه الإذن. ويمكن أن يحدث أيٌّ من الأمرين في أي يوم، ولذلك يُستحسن فحص الـ token وفق جدول زمني، لا عند فشل الاستدعاء وحده.
كيف يُعالَج الخطأ؟
بالحصول على token جديد. لا يعمل التجديد إلا على token ما زال صالحًا، لذلك فبمجرد ظهور الخطأ 190 يكون الوقت قد فات للتجديد. يسجّل صاحب الحساب الدخول عبر Instagram من جديد، فيصدر token قصير الأمد جديد يبادله التطبيق بـ token طويل الأمد. ومن ذلك الحين، جدّده وفق جدول زمني، قبل انتهاء الـ 60 يومًا بمدة كافية.
الأخطاء الشائعة
- انتظار فشل الـ token قبل تجديده. الـ token المنتهي لا يمكن تجديده، لذا جدّده بينما ما زال صالحًا.
- التجديد المبكر أكثر من اللازم. الـ token طويل الأمد الذي يقل عمره عن 24 ساعة لا يمكن تجديده بعد، لذا فحدّد موعد أول تجديد بعد ذلك.
- الاحتفاظ بنسخ من الـ token في أماكن عدة. تجديد نسخة واحدة لا يجدد النسخ الأخرى، فتفشل تلك النسخ في النهاية بالخطأ 190.
- إعادة إرسال الاستدعاء. الـ token المرفوض يبقى مرفوضًا، ولا يحل الخطأ إلا token جديد.
وإذا رفضت Meta الـ token أثناء استدعاء، يُعلَّم الاتصال فورًا لإعادة الربط ويُرسَل البريد. وتضيف أدوات MCP الـ token الحالي إلى كل استدعاء، فلا توجد نسخة تُخزَّن. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية لمدة 3 أيام.
الأسئلة الشائعة
ماذا تعني الأكواد الفرعية 463 و467 مع الخطأ 190؟
يعني الكود 463 أن الـ token انتهت صلاحيته، ويعني 467 أنه غير صالح، كأن يكون مُلغى مثلًا. وفي الحالتين، يسجّل صاحب الحساب الدخول عبر Instagram من جديد للحصول على token جديد.
هل يمكن تجديد الـ token المنتهي الصلاحية؟
لا. يحتاج التجديد إلى token لم تنتهِ صلاحيته، لذلك يلزم صاحب الحساب بعد انتهاء الصلاحية أن يسجّل الدخول عبر Instagram من جديد.
هل يعطّل تغيير كلمة المرور رمز الوصول؟
قد يحدث ذلك. تُبلِّغ Meta بالجلسة المنتهية بتغيير كلمة المرور بالكود الفرعي 460، ويلزم الشخص بعدها تسجيل الدخول من جديد.
هل أحتاج إلى إعادة الربط بعد الخطأ 190؟
فقط إذا رُفض الـ token الحالي للحساب. أما إذا استخدم الاستدعاء نسخة مخزنة قديمة، فيكفي جلب الـ token الحالي؛ وإلا فعلى صاحب الحساب تسجيل الدخول عبر Instagram من جديد.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في