تحديث الرمز

إنشاء رمز API جديد وإبطال الرمز القديم فوراً.

POST/api/token/update

المصادقة:API Key

الحد:30/دقيقة

معلمات الطلب

يمكن تمرير جميع المعلمات عبر Query أو Body

اسم المعلمة	النوع	مطلوب	الوصف
`token`	string	مطلوب	رمز API الحالي، يصبح غير صالح فور نجاح الطلب مثال: your_api_token_here

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

اسم المعلمة	النوع	مطلوب	الوصف
`code`	number	مطلوب	رمز الحالة مثال: 1
`msg`	string	مطلوب	رسالة الاستجابة مثال: 刷新成功
`data.username`	string	مطلوب	اسم المستخدم مثال: testuser
`data.token`	string	مطلوب	رمز API الجديد مثال: new_api_token_here
`data.expire_time`	number	مطلوب	وقت الانتهاء الذي يرثه الرمز الجديد، 0 يعني دائم مثال: 1772267945
`data.old_token_invalidated`	boolean	مطلوب	هل تم إبطال الرمز القديم مثال: true

مثال الاستجابة

{

"code":1,

"msg":"تم التحديث بنجاح",

"time":1769675945,

"data":

{

"username":"testuser",

"token":"new_api_token_here",

"expire_time":1772267945,

"old_token_invalidated":true

}

"ysucc":"Ysucc"

}

رموز الخطأ

رموز الخطأ3 معرّف

0

الرمز مطلوب

معامل token مفقود

0

الرمز غير صحيح

الرمز غير صالح أو تم استبداله أو حالة الحساب غير متاحة

0

انتهت صلاحية الرمز

لا يمكن للرموز المنتهية تحديث الرمز

لغة الاستجابة

خصص لغة استجابة API باستخدام ترويسة X-Lang. تستخدم أمثلة الكود أدناه لغة الموقع الحالية تلقائيًا.

الترويسة الموصى بها

X-Lang: ar

اللغات المدعومة

zh, en, zh-TW, vi, ar

يمكن أيضًا استخدام Accept-Language؛ وتكون الأولوية لـ X-Lang. تعود اللغات غير المدعومة إلى الإنجليزية.

أمثلة الكود

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/token/update" \
  -H "X-Lang: ar" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here"

ملاحظات

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

جرّب في وحدة التحكم

املأ المعلمات أدناه ثم أرسل الطلب للاختبار. تُرسَل الطلبات إلى واجهة هذا الموقع فقط؛ العنوان مقفل ولا يمكن تغييره، ويُرفَق ملف تعريف الارتباط لتسجيل دخولك الحالي.

POSThttps://testypro.iwai.cc/api/token/updateمقفل على هذا الموقع

tokenstringمطلوب

رمز API الحالي، يصبح غير صالح فور نجاح الطلب