GETPOST
v1.0.0stable獲取證書
通過 Token 和證書 ID 或 UDID 獲取證書，通過 UDID 查詢時支援智能選擇最佳證書
GET | POST
/api/getcertificate驗證:API Key
速率限制:120/分鐘
請求參數
所有請求參數需透過 Query 或 Body 傳遞
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
token | string | 必填 | 用戶 API Token 範例: your_api_token_here |
id | string | 選填 | 證書 ID，與 udid 二選一，同時提供時優先使用 id 範例: AB12CD34 |
udid | string | 選填 | 設備 UDID，與 id 二選一，通過 UDID 查詢時會智能選擇最佳證書 範例: 00008020-001A2B3C4D5E6F78 |
回應參數
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
code | number | 必填 | 狀態碼：1=成功，0=失敗，2=無可用證書，3=證書已到期 範例: 1 |
msg | string | 必填 | 返回訊息 範例: 返回成功 |
time | number | 必填 | 伺服器時間戳（Unix 秒） 範例: 1769675945 |
data | object | 必填 | 業務數據 |
data.id | string | 必填 | 證書 ID 範例: AB12CD34 |
data.pname | string | 必填 | 專案名稱 範例: MyApp |
data.addtime | number | 必填 | 添加時間（Unix 時間戳） 範例: 1706500000 |
data.pool | number | 必填 | 池標識：0=公共池，1=獨立池 範例: 0 |
data.type | number | 必填 | 池類型：0=公共池，1=獨立池 範例: 0 |
data.mobileprovision | string | 必填 | Base64 編碼的 mobileprovision 範例: MIIPhgYJKoZIhvcNAQcCoII...(Base64) |
data.p12 | string | 必填 | Base64 編碼的 P12 證書 範例: MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64) |
data.state | boolean | 必填 | 證書有效狀態：true=有效，false=已掉簽 範例: true |
data.warranty | boolean | 必填 | 是否有售後保障 範例: true |
data.warranty_time | number | 必填 | 售後到期時間（Unix 時間戳） 範例: 1738000000 |
data.shtype | number | 必填 | 售後類型：0=躺平版，1=標準版，2=加強版，3=穩定版，4=擺爛版，6=高擺爛版 範例: 1 |
ysucc | string | 必填 | 成功標識，成功時返回 "Ysucc" 範例: Ysucc |
回應示例
{}
"code":1,
"msg":"返回成功",
"time":1769675945,
"data":
{}
,"id":"AB12CD34",
"pname":"MyApp",
"addtime":1706500000,
"pool":0,
"type":0,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)",
"state":true,
"warranty":true,
"warranty_time":1738000000,
"shtype":1
"ysucc":"Ysucc"
錯誤碼
錯誤碼7 個定義
0token驗證失敗
Token 無效或已過期
0證書ID或UDID至少需要一個不為空
必須提供 id 或 udid 參數
0證書ID不存在
指定的證書 ID 不存在或不屬於當前用戶
回應語言
透過 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/getcertificate?token=your_api_token_here&id=AB12CD34&udid=00008020-001A2B3C4D5E6F78" \
-H "X-Lang: zh-TW"注意事項
- 支援 GET 和 POST 請求
- 參數通過 Query 或 x-www-form-urlencoded 傳遞
- id 和 udid 二選一，同時提供時優先使用 id
- 通過 UDID 查詢時智能選擇最佳證書：優先返回正常狀態
- state=false 表示證書已掉簽，但仍可下載使用
- warranty_time 為售後到期時間，到期後如掉簽需要重新購買
在控制台試一試
在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。
https://testypro.iwai.cc/api/getcertificate?token=your_api_token_here&id=AB12CD34&udid=00008020-001A2B3C4D5E6F78已鎖定本站string必填
用戶 API Token
string
證書 ID，與 udid 二選一，同時提供時優先使用 id
string
設備 UDID，與 id 二選一，通過 UDID 查詢時會智能選擇最佳證書