返回首頁API 文件
語言: 繁體中文
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
返回文檔列表
GETPOST
v1.0.0stable

證書檢測

使用 Token 鑑權，通過證書 KID 或設備 UDID 檢測證書狀態

GET | POST/api/device/certcheck
驗證:API Key
速率限制:30/分鐘

請求參數

所有請求參數需透過 Query 或 Body 傳遞

參數名類型必填說明
token
string必填
用戶 API Token
範例: your_api_token_here
kid
string選填
證書 KID，與 udid 二選一
範例: ABC123XYZ
udid
string選填
設備 UDID，與 kid 二選一
範例: 00008030-001234567890002E

回應參數

參數名類型必填說明
code
number必填
API 調用狀態碼：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":"存在多個匹配設備，請指定具體證書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 不能為空
未提供 Token 參數
10
Token 無效
Token 無效或已過期
20
請提供 kid 或 udid
未提供 kid 或 udid

回應語言

透過 X-Lang 請求標頭自訂介面回應語言。下方程式碼示例會自動使用您目前瀏覽系統的語言。

建議請求標頭
X-Lang: zh-TW
支援的語言
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: zh-TW"

注意事項

  • 支援 GET 和 POST 請求
  • kid 或 udid 二選一，至少提供一個
  • 若同一 UDID 存在多個證書，將返回多證書提示
  • 線上檢測：可檢測證書有效期 + 是否被吐銷（掉簽），需要網絡
  • 本地檢測：僅檢測證書有效期，無法檢測證書是否被吐銷
  • 線上檢測不可用時自動回退到本地檢測，can_detect_revoke=false
  • 檢測到掉簽/封禁狀態時會自動更新設備狀態為 hidden
  • 建議不要頻繁調用此接口，以免觸發 Apple 風控

在控制台試一試

在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。

https://testypro.iwai.cc/api/device/certcheck?token=your_api_token_here&kid=ABC123XYZ&udid=00008030-001234567890002E已鎖定本站
string必填

用戶 API Token

string

證書 KID，與 udid 二選一

string

設備 UDID，與 kid 二選一