GETPOST
v1.0.0stable証明書状態確認
トークン認証と証明書KIDまたはデバイスUDIDを使用して証明書ステータスを確認する
GET | POST
/api/device/certcheckauth:API Key
制限:30/分
リクエストパラメータ
すべてのパラメータは、クエリまたは本文を介して渡すことができます
| パラメーター | タイプ | 必須 | 内容 |
|---|---|---|---|
token | string | 必須 | API トークン 例: your_api_token_here |
kid | string | オプション | 証明書KID。KIDまたはUDIDのいずれかを提供します 例: ABC123XYZ |
udid | string | オプション | デバイスUDID。KIDまたはUDIDのいずれかを指定します 例: 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 | 必須 | <bpt i="1000001" type="formatting" x="1000001">{b></bpt>詳細<ept i="1000001"><b}</ept> 例: 证书有效,剩余 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 defined
12トークンは必須です。
トークンパラメータがありません
10無効なトークン
無効なまたは期限切れの Nonce トークン!
20KIDまたはUDIDを入力してください
KIDまたはUDIDがありません
X-Lang: enzh, en, zh-TW, vi, arコード例
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: en"注
- GETとPOSTの両方をサポート
- KIDまたはUDIDの少なくとも1つを提供してください
- 同じUDIDに複数の証明書が存在する場合、は複数の証明書プロンプトを返します
- オンラインチェック:有効性+失効ステータスを検出できます。ネットワークが必要です
- ローカルチェック:有効期間のみをチェックし、失効を検出できません
- オンラインが利用できない場合、ローカルチェックに戻ります。CAN_DETECT_REVOKE = FALSE
- ドロップ/禁止が検出されると、デバイスステータスが自動的に非表示に更新されます
- ステータスコード: 205 =正常、203 =期限切れ、204 =失効、206 =廃棄、207 =禁止、208 =不明
- Appleのレート制限を防ぐために頻繁な通話を避ける
コンソールでお試しください
以下のパラメータを入力し、テストのリクエストを送信します。リクエストはこのサイトのAPIにのみ行きます。URLはロックされており、変更することはできません。現在のログインCookieが含まれています。
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のいずれかを指定します