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

Auth:API Key

Granica:30/minute

Parametry żądania

Wszystkie parametry mogą być przekazywane za pośrednictwem zapytania lub ciała

Parametr	Rodzaj	Wymagane	Opis
`token`	string	Wymagane	User API token Przykład: your_api_token_here
`kid`	string	Opcjonalnie	Certificate KID. Provide either kid or udid Przykład: ABC123XYZ
`udid`	string	Opcjonalnie	Device UDID. Provide either kid or udid Przykład: 00008030-001234567890002E

Odpowiedź

Parametr	Rodzaj	Wymagane	Opis
`code`	number	Wymagane	API call status: 1=success, others=failure Przykład: 1
`msg`	string	Wymagane	Response message Przykład: 证书状态正常
`time`	number	Wymagane	Server timestamp (Unix seconds) Przykład: 1769675945
`data`	object	Wymagane	Response payload
`data.status`	string	Wymagane	Certificate status: normal/expired/revoked/banned/dropped/unknown Przykład: normal
`data.status_code`	number	Wymagane	Status code: 205=normal, 203=expired, 204=revoked, 207=banned, 206=dropped, 208=unknown Przykład: 205
`data.status_text`	string	Wymagane	Status text Przykład: 正常
`data.details`	string	Wymagane	Details Przykład: 证书有效，剩余 180 天过期
`data.check_method`	string	Wymagane	Check method: Online check / Local check Przykład: 在线检测
`data.can_detect_revoke`	boolean	Wymagane	Can detect revocation: true=online check available, false=local check only (validity period only) Przykład: true
`data.revoked_at`	string	Wymagane	Revocation time (only for revoked/banned) Przykład: 2026-01-15 10:30:00
`data.expires_at`	string	Wymagane	Certificate expiration time Przykład: 2027-01-28 15:30:00
`data.remaining_days`	number	Wymagane	Remaining valid days Przykład: 180
`data.cert_info`	object	Wymagane	Certificate information
`data.cert_info.common_name`	string	Wymagane	Certificate common name Przykład: Apple Development: John Doe (XXXXXXXXXX)
`data.cert_info.valid_from`	string	Wymagane	Certificate valid from Przykład: 2026-01-28 15:30:00
`data.cert_info.valid_to`	string	Wymagane	Certificate valid to Przykład: 2027-01-28 15:30:00
`data.device`	object	Wymagane	Device information
`ip`	string	Wymagane	Requester IP address Przykład: 192.168.1.100
`ysucc`	string	Wymagane	Success flag, returns "Ysucc" on success Przykład: Ysucc

Przykład odpowiedzi

{

"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"

}

Kod błędu

Kod błędu8 zdefiniowane

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

Język odpowiedzi

Dostosuj język odpowiedzi API do nagłówka X- Lang. Poniższe przykłady kodów automatycznie korzystają z aktualnego języka strony.

Zalecany nagłówek

X-Lang: pl

Obsługiwane języki

zh, en, zh-TW, vi, ar, es, ru

Obsługiwane jest również Accept- Language; X- Lang ma pierwszeństwo. Nieobsługiwane języki podążają za zapasami języka strony.

Przykłady kodów

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: pl"

Uwagi

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

Spróbuj w konsoli

Wypełnij poniższe parametry i wyślij wniosek o przetestowanie. Żądania są kierowane tylko do API tej witryny; adres URL jest zablokowany i nie może być zmieniony, a obecne pliki cookie logowania są włączone.

https://testypro.iwai.cc/api/device/certcheck?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002EZamknięte na tej stronie

tokenstringWymagane

User API token

kidstring

Certificate KID. Provide either kid or udid

udidstring

Device UDID. Provide either kid or udid