GETPOST
v1.0.0stableفحص حالة الشهادة
فحص حالة الشهادة باستخدام مصادقة الرمز و KID للشهادة أو UDID للجهاز
GET | POST
/api/device/certcheckالمصادقة:API Key
الحد:30/دقيقة
معلمات الطلب
يمكن تمرير جميع المعلمات عبر Query أو Body
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
token | string | مطلوب | رمز API للمستخدم مثال: your_api_token_here |
kid | string | اختياري | KID للشهادة. قدم إما kid أو udid مثال: ABC123XYZ |
udid | string | اختياري | UDID للجهاز. قدم إما kid أو udid مثال: 00008030-001234567890002E |
معلمات الاستجابة
| اسم المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
code | number | مطلوب | رمز حالة الاستدعاء: 1=نجاح، غيره=فشل مثال: 1 |
msg | string | مطلوب | رسالة الاستجابة مثال: 证书状态正常 |
time | number | مطلوب | الطابع الزمني للخادم (ثواني Unix) مثال: 1769675945 |
data | object | مطلوب | بيانات الاستجابة |
data.status | string | مطلوب | حالة الشهادة: normal/expired/revoked/banned/dropped/unknown مثال: normal |
data.status_code | number | مطلوب | رمز الحالة: 205=عادي، 203=منتهي، 204=ملغي، 207=محظور، 206=ساقط، 208=غير معروف مثال: 205 |
data.status_text | string | مطلوب | نص الحالة مثال: 正常 |
data.details | string | مطلوب | التفاصيل مثال: 证书有效，剩余 180 天过期 |
data.check_method | string | مطلوب | طريقة الفحص: عبر الإنترنت / محلي مثال: 在线检测 |
data.can_detect_revoke | boolean | مطلوب | هل يمكن كشف الإلغاء: true=فحص عبر الإنترنت متاح، false=فحص محلي فقط مثال: true |
data.revoked_at | string | مطلوب | وقت الإلغاء (فقط للملغي/المحظور) مثال: 2026-01-15 10:30:00 |
data.expires_at | string | مطلوب | وقت انتهاء الشهادة مثال: 2027-01-28 15:30:00 |
data.remaining_days | number | مطلوب | الأيام المتبقية الصالحة مثال: 180 |
data.cert_info | object | مطلوب | معلومات الشهادة |
data.cert_info.common_name | string | مطلوب | الاسم الشائع للشهادة مثال: Apple Development: John Doe (XXXXXXXXXX) |
data.cert_info.valid_from | string | مطلوب | بداية صلاحية الشهادة مثال: 2026-01-28 15:30:00 |
data.cert_info.valid_to | string | مطلوب | نهاية صلاحية الشهادة مثال: 2027-01-28 15:30:00 |
data.device | object | مطلوب | معلومات الجهاز |
ip | string | مطلوب | عنوان IP للطالب مثال: 192.168.1.100 |
ysucc | string | مطلوب | علامة النجاح، ترجع "Ysucc" عند النجاح مثال: Ysucc |
مثال الاستجابة
{}
"code":1,
"msg":"حالة الشهادة طبيعية",
"time":1769675945,
"data":
{}
,"status":"normal",
"status_code":205,
"status_text":"正常",
"details":"在线验证通过，证书有效，剩余 180 天过期",
"check_method":"在线检测",
"can_detect_revoke":true,
"revoked_at":"",
"expires_at":"2027-01-28 15:30:00",
"remaining_days":180,
"cert_info":
{}
,"common_name":"Apple Development: John Doe (XXXXXXXXXX)",
"valid_from":"2026-01-28 15:30:00",
"valid_to":"2027-01-28 15:30:00",
"issuer":"Apple Inc.",
"country":"CN"
"device":
{}
"id":12345,
"kid":"ABC123XYZ",
"udid":"00008030-001234567890002E",
"pname":"MyApp Development",
"model":"iPhone 15 Pro",
"shtype":1,
"zt":"normal"
"ip":"192.168.1.100",
"ysucc":"Ysucc"
الشهادة سقطت (عبر الإنترنت)
اكتشف الفحص عبر الإنترنت سقوط الشهادة
الشهادة سقطت (عبر الإنترنت)
{}
"code":1,
"msg":"الشهادة سقطت",
"time":1769675945,
"data":
{}
,"status":"dropped",
"status_code":206,
"status_text":"掉签",
"details":"证书已被吊销",
"check_method":"在线检测",
"can_detect_revoke":true,
"device":
{}
"id":12345,
"kid":"ABC123XYZ",
"udid":"00008030-001234567890002E",
"pname":"MyApp Development",
"zt":"hidden"
"ip":"192.168.1.100",
"ysucc":"Ysucc"
الحساب محظور
تم حظر حساب المطور بواسطة Apple
الحساب محظور
{}
"code":1,
"msg":"تم حظر حساب المطور",
"time":1769675945,
"data":
{}
,"status":"banned",
"status_code":207,
"status_text":"账号封禁",
"details":"Apple 封禁了该开发者账号",
"check_method":"在线检测",
"can_detect_revoke":true,
"revoked_at":"2026-01-15 10:30:00",
"device":
{}
"id":12345,
"zt":"hidden"
"ip":"192.168.1.100",
"ysucc":"Ysucc"
فحص محلي (الفحص عبر الإنترنت غير متاح)
الفحص عبر الإنترنت غير متاح، الرجوع للفحص المحلي
فحص محلي (الفحص عبر الإنترنت غير متاح)
{}
"code":1,
"msg":"صلاحية الشهادة طبيعية (لم يتم التحقق من حالة الإلغاء)",
"time":1769675945,
"data":
{}
,"status":"normal",
"status_code":205,
"status_text":"正常",
"details":"本地检测：证书在有效期内，剩余 180 天过期。注意：在线检测不可用，无法确认证书是否被吊销",
"check_method":"本地检测（网络不可用）",
"can_detect_revoke":false,
"expires_at":"2027-01-28 15:30:00",
"remaining_days":180,
"device":
{}
"id":12345,
"pname":"MyApp Development",
"zt":"normal"
"ip":"192.168.1.100",
"ysucc":"Ysucc"
تم العثور على عدة شهادات
توجد عدة شهادات لنفس UDID، استخدم kid للتحديد
تم العثور على عدة شهادات
{}
"code":103,
"msg":"تم العثور على عدة أجهزة، يرجى تحديد معرف الشهادة",
"time":1769675945,
"data":
{}
,"count":3,
"devices":
[]
{}
,"id":12345,
"kid":"ABC123",
"pname":"App A",
"shtype":1
{}
,"id":12346,
"kid":"DEF456",
"pname":"App B",
"shtype":2
{}
"id":12347,
"kid":"GHI789",
"pname":"App C",
"shtype":1
"ip":"192.168.1.100",
"yno":"Yno"
رموز الخطأ
رموز الخطأ8 معرّف
12الرمز مطلوب
معامل Token مفقود
10الرمز غير صالح
رمز غير صالح أو منتهي الصلاحية
20يرجى تقديم kid أو udid
kid أو udid مفقود
لغة الاستجابة
خصص لغة استجابة 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/device/certcheck?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E" \
-H "X-Lang: ar"ملاحظات
- يدعم GET و POST
- قدم واحداً على الأقل من: kid أو udid
- إذا وُجدت عدة شهادات لنفس UDID، يتم إرجاع تنبيه
- الفحص عبر الإنترنت: يكشف الصلاحية + حالة الإلغاء، يتطلب اتصالاً بالشبكة
- الفحص المحلي: يتحقق فقط من فترة الصلاحية، لا يكشف الإلغاء
- يرجع للفحص المحلي عند عدم توفر الفحص عبر الإنترنت
- يتم تحديث حالة الجهاز تلقائياً إلى hidden عند اكتشاف الإلغاء/الحظر
- تجنب الاستدعاء المتكرر لمنع تقييد Apple
جرّب في وحدة التحكم
املأ المعلمات أدناه ثم أرسل الطلب للاختبار. تُرسَل الطلبات إلى واجهة هذا الموقع فقط؛ العنوان مقفل ولا يمكن تغييره، ويُرفَق ملف تعريف الارتباط لتسجيل دخولك الحالي.
https://testypro.iwai.cc/api/device/certcheck?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002Eمقفل على هذا الموقعstringمطلوب
رمز API للمستخدم
string
KID للشهادة. قدم إما kid أو udid
string
UDID للجهاز. قدم إما kid أو udid