GETPOST

v2.2.0stable

新增設備 V2

統一單設備新增接口。通過一個參數切換秒出或審核/預約模式，同時保留舊接口可繼續使用。

GET | POST/api/adddevice/v2

驗證:API Key

速率限制:60/分鐘

請求參數

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

參數名	類型	必填	說明
`token`	string	必填	用戶 API Token 範例: your_api_token_here
`udid`	string	必填	設備 UDID（長度必須為 25 或 40）範例: 00008030-001234567890ABCD
`mode`	string	選填	新增模式：instant=秒出，review=審核/預約。預設 instant instantreview 範例: instant
`add_mode`	string	選填	mode 的別名，優先級高於 mode instantreview 範例: review
`force`	boolean	選填	是否強制新增。true/1/yes/y/on 會跳過強制新增期和已存在返回邏輯範例: true
`warranty`	string	選填	售後類型：0/1/2/3/4/6。review 模式不支援 4/6 012346 範例: 1
`shtype`	string	選填	warranty 的相容別名 012346 範例: 1
`type`	string	選填	池類型：0=公共池，1=獨立池 01 範例: 0
`deviceType`	string	選填	設備類型：iphone 或 ipad iphoneipad 範例: iphone
`beizhu`	string	選填	備註範例: 测试设备
`code`	string	選填	卡密（可選）範例: ABC123XYZ

回應參數

參數名	類型	必填	說明
`code`	number	必填	狀態碼範例: 1
`msg`	string	必填	返回訊息範例: 添加成功
`data.id`	string	必填	證書 ID/預約單號範例: AB12CD34
`data.mobileprovision`	string	必填	Base64 mobileprovision，review 模式審核中可能為空範例: Base64EncodedString...
`data.p12`	string	必填	Base64 P12 證書範例: Base64EncodedString...

回應示例

{

"code":1,

"msg":"添加成功",

"time":1769675945,

"data":

{

"id":"AB12CD34",

"pool":0,

"addtime":1706500000,

"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",

"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"

}

"ysucc":"Ysucc"

}

錯誤碼

錯誤碼3 個定義

0

token錯誤

Token 無效或已過期

0

UDID格式錯誤

UDID 長度必須為 25 或 40

0

強制新增期內

可傳 force=true 強制嘗試重新新增

回應語言

透過 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/adddevice/v2" \
  -H "X-Lang: zh-TW" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_api_token_here",
    "udid": "00008030-001234567890ABCD",
    "mode": "instant",
    "add_mode": "review",
    "force": true,
    "warranty": "1",
    "shtype": "1",
    "type": "0",
    "deviceType": "iphone",
    "beizhu": "测试设备",
    "code": "ABC123XYZ"
  }'

注意事項

舊接口 /api/adddevice 和 /api/addyydevice 仍保留並保持相容
mode=instant 復用秒出新增邏輯；mode=review 復用預約/審核新增邏輯
支援 Query、form 和 JSON body；V2 建議使用 JSON body
force=true 僅跳過本系統強制新增期/已存在短路判斷，不保證 Apple 側允許重複註冊
review 模式仍遵循預約接口限制，例如不支援 warranty=4/6

在控制台試一試

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

https://testypro.iwai.cc/api/adddevice/v2?token=your_api_token_here&udid=00008030-001234567890ABCD&mode=instant&add_mode=review&force=true&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZ

已鎖定本站

tokenstring必填

用戶 API Token

udidstring必填

設備 UDID（長度必須為 25 或 40）

modestring

新增模式：instant=秒出，review=審核/預約。預設 instant

add_modestring

mode 的別名，優先級高於 mode

forceboolean

是否強制新增。true/1/yes/y/on 會跳過強制新增期和已存在返回邏輯

warrantystring

售後類型：0/1/2/3/4/6。review 模式不支援 4/6

shtypestring

warranty 的相容別名

typestring

池類型：0=公共池，1=獨立池

deviceTypestring

設備類型：iphone 或 ipad

beizhustring

備註

codestring

卡密（可選）