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 个定义

0

token错误

Token 无效或已过期

0

UDID格式错误

UDID 长度必须为 25 或 40

0

余额不足

账户余额不足

响应语言

通过 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/addyydevice" \
  -H "X-Lang: zh" \
  -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 为空通常表示审核中，可通过设备列表接口查询状态

在控制台试一试

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

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

已锁定本站

tokenstring必填

用户 API Token

udidstring必填

设备 UDID，长度必须为 25 或 40

warrantystring

售后类型：0/1/2/3/4/6。建议显式传入

shtypestring

warranty 的别名，仅在 warranty 为空时生效

typestring

池类型：0=公共池，1=独立池。默认 0

deviceTypestring

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

beizhustring