GETPOST
v1.0.0stable

Check Certificate Status

Check certificate status using token authentication and either a certificate KID or device UDID

GET | POST/api/device/certcheck
Афіша:API Key
Ліміт:30/minute

Параметри запиту

Всі параметри можуть бути передані через Query або тіло

ПараметрТипПотрібніОпис
token
stringПотрібні
User API token
Приклад: your_api_token_here
kid
stringДодатково
Certificate KID. Provide either kid or udid
Приклад: ABC123XYZ
udid
stringДодатково
Device UDID. Provide either kid or udid
Приклад: 00008030-001234567890002E

Відправити

ПараметрТипПотрібніОпис
code
numberПотрібні
API call status: 1=success, others=failure
Приклад: 1
msg
stringПотрібні
Response message
Приклад: 证书状态正常
time
numberПотрібні
Server timestamp (Unix seconds)
Приклад: 1769675945
data
objectПотрібні
Response payload
data.status
stringПотрібні
Certificate status: normal/expired/revoked/banned/dropped/unknown
Приклад: normal
data.status_code
numberПотрібні
Status code: 205=normal, 203=expired, 204=revoked, 207=banned, 206=dropped, 208=unknown
Приклад: 205
data.status_text
stringПотрібні
Status text
Приклад: 正常
data.details
stringПотрібні
Details
Приклад: 证书有效,剩余 180 天过期
data.check_method
stringПотрібні
Check method: Online check / Local check
Приклад: 在线检测
data.can_detect_revoke
booleanПотрібні
Can detect revocation: true=online check available, false=local check only (validity period only)
Приклад: true
data.revoked_at
stringПотрібні
Revocation time (only for revoked/banned)
Приклад: 2026-01-15 10:30:00
data.expires_at
stringПотрібні
Certificate expiration time
Приклад: 2027-01-28 15:30:00
data.remaining_days
numberПотрібні
Remaining valid days
Приклад: 180
data.cert_info
objectПотрібні
Certificate information
data.cert_info.common_name
stringПотрібні
Certificate common name
Приклад: Apple Development: John Doe (XXXXXXXXXX)
data.cert_info.valid_from
stringПотрібні
Certificate valid from
Приклад: 2026-01-28 15:30:00
data.cert_info.valid_to
stringПотрібні
Certificate valid to
Приклад: 2027-01-28 15:30:00
data.device
objectПотрібні
Device information
ip
stringПотрібні
Requester IP address
Приклад: 192.168.1.100
ysucc
stringПотрібні
Success flag, returns "Ysucc" on success
Приклад: Ysucc
Приклад відповіді
{
"code":1,
"msg":"Certificate status normal",
"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"
}

Certificate Dropped (Online)

Online check detected certificate dropped

Certificate Dropped (Online)
{
"code":1,
"msg":"Certificate dropped",
"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"
}

Account Banned

Developer account has been banned by Apple

Account Banned
{
"code":1,
"msg":"Developer account has been banned",
"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"
}

Local Check (Online Unavailable)

Online check unavailable, fallback to local check, validity period only

Local Check (Online Unavailable)
{
"code":1,
"msg":"Certificate validity normal (revocation not verified)",
"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"
}

Multiple Certificates Found

Multiple certificates exist for same UDID, use kid to specify

Multiple Certificates Found
{
"code":103,
"msg":"Multiple devices found, please specify certificate ID",
"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 is required
Token parameter is missing
10
Invalid token
Invalid or expired token
20
Please provide kid or udid
Missing kid or udid

Мова відповіді

Налаштуйте мову відповіді API з заголовком X-Lang. Приклади коду нижче автоматично використовуйте мову поточного сайту.

Рекомендований заголовок
X-Lang: uk
Підтримувані мови
zh, en, zh-TW, vi, ar, es, ru

За підтримки 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: uk"

Нотатки

  • 支持 GET 和 POST 请求
  • kid 或 udid 二选一,至少提供一个
  • 若同一UDID存在多个证书,将返回多证书提示
  • 在线检测:可检测证书有效期 + 是否被吊销(掉签),需要网络
  • 本地检测:仅检测证书有效期,无法检测证书是否被吊销
  • 在线检测不可用时自动回退到本地检测,此时 can_detect_revoke=false
  • 检测到掉签/封禁状态时会自动更新设备状态为 hidden
  • 建议不要频繁调用此接口,以免触发APPLE风控

Спробуйте в Консоль

Заповнювати параметри нижче і відправити запит на тест. Запити тільки перейти до цього API сайту; URL-адреса заблокована і не може бути змінена, і ваш поточний логін cookie включено.

https://testypro.iwai.cc/api/device/certcheck?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002EЗаблоковано на цей сайт
stringПотрібні

User API token

string

Certificate KID. Provide either kid or udid

string

Device UDID. Provide either kid or udid