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

Limite:30/minute

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

Parametro	Tipo	Obbligo	Descrizione
`token`	string	Obbligo	User API token Esempio: your_api_token_here
`kid`	string	Facoltativo	Certificate KID. Provide either kid or udid Esempio: ABC123XYZ
`udid`	string	Facoltativo	Device UDID. Provide either kid or udid Esempio: 00008030-001234567890002E

Risposta

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

Esempio di risposta

{

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

}

Codici di errore

Codici di errore8 definito

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

Lingua di risposta

Personalizza il linguaggio di risposta API con l'intestazione X-Lang. Gli esempi di codice qui sotto utilizzano automaticamente la lingua del tuo sito corrente.

Intestazione consigliata

X-Lang: it

Lingue supportate

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

Accetta-Language è anche supportato; X-Lang prende la priorità.

Esempi di codice

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

Note

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

Provalo in Console

Compila i parametri qui sotto e invia una richiesta al test. Le richieste vanno solo all'API di questo sito; l'URL è bloccato e non può essere modificato e il cookie di login corrente è incluso.

https://testypro.iwai.cc/api/device/certcheck?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002EBloccato a questo sito

tokenstringObbligo

User API token

kidstring

Certificate KID. Provide either kid or udid

udidstring

Device UDID. Provide either kid or udid