GET
v1.0.0stableاستعلام صلاحية الرمز
استرجاع وقت انتهاء الصلاحية وحالة صلاحية رمز API
GET
/api/token/expireالمصادقة:API Key
الحد:120/دقيقة
معلمات الطلب
يمكن تمرير جميع المعلمات عبر Query أو Body
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
token | string | مطلوب | رمز API للمستخدم مثال: your_api_token_here |
معلمات الاستجابة
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
code | number | مطلوب | رمز الحالة: 1=نجاح، 0=فشل مثال: 1 |
msg | string | مطلوب | رسالة الاستجابة مثال: 查询成功 |
time | number | مطلوب | الطابع الزمني للخادم (ثواني Unix) مثال: 1769675945 |
data | object | مطلوب | بيانات الاستجابة |
data.username | string | مطلوب | اسم المستخدم مثال: testuser |
data.expire_time | number | مطلوب | الطابع الزمني للانتهاء (ثواني Unix). 0 يعني دائم مثال: 1769675945 |
data.status | string | مطلوب | الحالة: permanent=دائم، valid=صالح، expired=منتهي مثال: valid |
data.status_text | string | مطلوب | نص الحالة مثال: 有效 |
data.is_valid | boolean | مطلوب | هل الرمز صالح مثال: true |
data.remaining_seconds | number | مطلوب | الثواني المتبقية (-1 يعني دائم) مثال: 2592000 |
data.remaining_days | number | مطلوب | الأيام المتبقية (-1 يعني دائم) مثال: 30 |
data.expire_time_formatted | string | مطلوب | وقت الانتهاء المنسق (لا يُرجع إذا كان دائماً) مثال: 2026-02-28 15:04:05 |
ysucc | string | مطلوب | علامة النجاح، ترجع "Ysucc" عند النجاح مثال: Ysucc |
مثال الاستجابة
{}
"code":1,
"msg":"نجح الاستعلام",
"time":1769675945,
"data":
{}
,"username":"testuser",
"expire_time":1772267945,
"status":"valid",
"status_text":"有效",
"is_valid":true,
"remaining_seconds":2592000,
"remaining_days":30,
"expire_time_formatted":"2026-02-28 15:04:05"
"ysucc":"Ysucc"
رمز دائم
يرجع دائم عندما لا يكون للرمز وقت انتهاء
رمز دائم
{}
"code":1,
"msg":"نجح الاستعلام",
"time":1769675945,
"data":
{}
,"username":"testuser",
"expire_time":0,
"status":"permanent",
"status_text":"永久有效",
"is_valid":true,
"remaining_seconds":-1,
"remaining_days":-1
"ysucc":"Ysucc"
رمز منتهي الصلاحية
تجاوز الرمز وقت انتهاء صلاحيته
رمز منتهي الصلاحية
{}
"code":1,
"msg":"نجح الاستعلام",
"time":1769675945,
"data":
{}
,"username":"testuser",
"expire_time":1769000000,
"status":"expired",
"status_text":"已过期",
"is_valid":false,
"expired_seconds":675945,
"expired_days":7,
"expire_time_formatted":"2026-01-21 12:26:40"
"ysucc":"Ysucc"
رموز الخطأ
رموز الخطأ3 معرّف
0الرمز مطلوب
معامل Token مفقود
0الرمز غير صحيح
رمز غير صالح أو تم استبداله
0يتم دعم طلبات GET فقط
تم استخدام طريقة غير GET
لغة الاستجابة
خصص لغة استجابة API باستخدام ترويسة X-Lang. تستخدم أمثلة الكود أدناه لغة الموقع الحالية تلقائيًا.
الترويسة الموصى بها
X-Lang: arاللغات المدعومة
zh, en, zh-TW, vi, arيمكن أيضًا استخدام Accept-Language؛ وتكون الأولوية لـ X-Lang. تعود اللغات غير المدعومة إلى الإنجليزية.
أمثلة الكود
curl -X GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/token/expire?token=your_api_token_here" \
-H "X-Lang: ar"ملاحظات
- expire_time بقيمة 0 يعني الرمز دائم
- remaining_seconds/remaining_days بقيمة -1 يعني دائم
- الرموز المنتهية لا يزال يمكن الاستعلام عنها، لكن is_valid = false
- الرموز المستبدلة لا يمكن الاستعلام عنها
جرّب في وحدة التحكم
املأ المعلمات أدناه ثم أرسل الطلب للاختبار. تُرسَل الطلبات إلى واجهة هذا الموقع فقط؛ العنوان مقفل ولا يمكن تغييره، ويُرفَق ملف تعريف الارتباط لتسجيل دخولك الحالي.
GET
https://testypro.iwai.cc/api/token/expire?token=your_api_token_hereمقفل على هذا الموقعstringمطلوب
رمز API للمستخدم