GETPOST
v2.1.0stable預約添加設備
預約模式添加設備。審核未完成時 mobileprovision 可能為空，可後續查詢狀態
GET | POST
/api/addyydevice驗證:API Key
速率限制:30/分鐘
請求參數
所有請求參數需透過 Query 或 Body 傳遞
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
token | string | 必填 | 用戶 API Token 範例: your_api_token_here |
udid | string | 必填 | 設備 UDID，長度必須為 25 或 40 範例: 00008030-001234567890ABCD |
warranty | string | 選填 | 售後類型：0/1/2/3/4/6。建議顯式傳入 012346 範例: 1 |
shtype | string | 選填 | warranty 的別名，僅在 warranty 為空時生效 012346 範例: 1 |
type | string | 選填 | 池類型：0=公共池，1=獨立池。預設 0 01 範例: 0 |
deviceType | string | 選填 | 設備類型：iphone 或 ipad。預設 iphone iphoneipad 範例: iphone |
beizhu | string | 選填 | 備註，最多 40 個字元 範例: 预约测试设备 |
回應參數
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
code | number | 必填 | 狀態碼：1=成功，0=失敗 範例: 1 |
msg | string | 必填 | 返回訊息 範例: 添加成功 |
time | number | 必填 | 伺服器時間戳（Unix 秒） 範例: 1769675945 |
data | object | 必填 | 業務數據 |
data.id | string | 必填 | 預約單號/證書 ID（通常為 5 位字母數字） 範例: A1B2C |
data.pool | number | 必填 | 池標識：0=公共池，1=獨立池 範例: 0 |
data.addtime | number | 必填 | 添加時間（Unix） 範例: 1706500000 |
data.mobileprovision | string | 必填 | Base64 mobileprovision（審核中時可能為空） 範例: Base64EncodedString... |
data.p12 | string | 必填 | Base64 P12 證書 範例: Base64EncodedString... |
data.state | boolean | 必填 | 證書有效狀態（部分分支返回） 範例: true |
ysucc | string | 必填 | 成功標識，成功時返回 "Ysucc" 範例: Ysucc |
回應示例
{}
"code":1,
"msg":"預約成功",
"time":1769675945,
"data":
{}
,"id":"A1B2C",
"pool":0,
"addtime":1706500000,
"mobileprovision":"",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
"ysucc":"Ysucc"
錯誤碼
錯誤碼4 個定義
0token錯誤
Token 無效或已過期
0UDID格式錯誤
UDID 長度必須為 25 或 40
0餘額不足
賬戶餘額不足
回應語言
透過 X-Lang 請求標頭自訂介面回應語言。下方程式碼示例會自動使用您目前瀏覽系統的語言。
建議請求標頭
X-Lang: zh-TW支援的語言
zh, en, zh-TW, vi, ar也可以使用 Accept-Language；X-Lang 優先級更高。不支援的語言將回退為英文。
程式碼示例
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/addyydevice" \
-H "X-Lang: zh-TW" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "token=your_api_token_here&udid=00008030-001234567890ABCD&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E9%A2%84%E7%BA%A6%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87"注意事項
- 參數需通過 Query 或 x-www-form-urlencoded 傳遞，後端不解析 JSON Body
- shtype 為 warranty 的相容參數，僅在 warranty 為空時使用
- mobileprovision 為空通常表示審核中，可通過設備列表接口查詢狀態
在控制台試一試
在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。
https://testypro.iwai.cc/api/addyydevice?token=your_api_token_here&udid=00008030-001234567890ABCD&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E9%A2%84%E7%BA%A6%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87已鎖定本站string必填
用戶 API Token
string必填
設備 UDID，長度必須為 25 或 40
string
售後類型：0/1/2/3/4/6。建議顯式傳入
string
warranty 的別名，僅在 warranty 為空時生效
string
池類型：0=公共池，1=獨立池。預設 0
string
設備類型：iphone 或 ipad。預設 iphone
string
備註，最多 40 個字元