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 的兼容别名，仅在 warranty 为空时生效 012346 示例: 1
`type`	string	可选	池类型：0=公共池，1=独立池。默认按原接口逻辑处理 01 示例: 0
`deviceType`	string	可选	设备类型：iphone 或 ipad。默认 iphone iphoneipad 示例: iphone
`beizhu`	string	可选	备注示例: 测试设备
`code`	string	可选	卡密（可选）示例: ABC123XYZ

响应参数

参数名	类型	必填	说明
`code`	number	必填	状态码：1=成功，0=失败示例: 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

支持的语言

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" \
  -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、x-www-form-urlencoded 和 JSON body；JSON body 更推荐用于 V2
force=true 仅跳过本系统强制添加期/已存在短路判断，不保证 Apple 侧一定允许重复注册
review 模式仍遵循预约接口限制，例如不支持 warranty=4/6

在控制台试一试

填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态

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 的兼容别名，仅在 warranty 为空时生效

typestring

池类型：0=公共池，1=独立池。默认按原接口逻辑处理

deviceTypestring

设备类型：iphone 或 ipad。默认 iphone

beizhustring

备注

codestring

卡密（可选）