GETPOST

v2.1.0stable

Add Device (Review/Reservation)

GET | POST/api/addyydevice

Auth:API Key

Limit:30/minute

Request Parameters

All parameters can be passed via Query or Body

Parameter	Type	Required	Description
`token`	string	Required	User API token Example: your_api_token_here
`udid`	string	Required	Device UDID. Length must be 25 or 40 characters Example: 00008030-001234567890ABCD
`warranty`	string	Optional	Warranty type: 0/1/2/3/4/6. Recommended to pass explicitly 012346 Example: 1
`shtype`	string	Optional	Alias of warranty. Used only when warranty is empty 012346 Example: 1
`type`	string	Optional	Pool type: 0=shared, 1=dedicated. Default is 0 01 Example: 0
`deviceType`	string	Optional	Device type: iphone or ipad. Default is iphone iphoneipad Example: iphone
`beizhu`	string	Optional	Remark. Up to 40 characters Example: 预约测试设备

Response

Parameter	Type	Required	Description
`code`	number	Required	Status code: 1=success, 0=failure Example: 1
`msg`	string	Required	Response message Example: 添加成功
`time`	number	Required	Server timestamp (Unix seconds) Example: 1769675945
`data`	object	Required	Response payload
`data.id`	string	Required	Reservation order / certificate ID (typically 5 alphanumeric characters) Example: A1B2C
`data.pool`	number	Required	Pool: 0=shared, 1=dedicated Example: 0
`data.addtime`	number	Required	Added time (Unix) Example: 1706500000
`data.mobileprovision`	string	Required	Base64-encoded mobileprovision (may be empty while review is pending) Example: Base64EncodedString...
`data.p12`	string	Required	Base64-encoded P12 certificate Example: Base64EncodedString...
`data.state`	boolean	Required	Certificate validity state (returned in some branches) Example: true
`ysucc`	string	Required	Success flag, returns "Ysucc" on success Example: Ysucc

Response Example

{

"code":1,

"msg":"Reservation successful",

"time":1769675945,

"data":

{

"id":"A1B2C",

"pool":0,

"addtime":1706500000,

"mobileprovision":"",

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

}

"ysucc":"Ysucc"

}

Error Codes

Error Codes4 defined

0

Invalid token

Invalid or expired token

0

Invalid UDID format

UDID length must be 25 or 40 characters

0

Insufficient balance

Response Language

Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.

Recommended Header

X-Lang: en

Supported Languages

zh, en, zh-TW, vi, ar

Accept-Language is also supported; X-Lang takes priority. Unsupported languages fall back to English.

Code Examples

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/addyydevice" \
  -H "X-Lang: en" \
  -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"

Notes

Send params via Query or x-www-form-urlencoded. JSON body is not parsed
shtype is a legacy alias of warranty, used only when warranty is empty
An empty mobileprovision usually indicates review is pending; check status via device list APIs

Try it in Console

Fill in the parameters below and send a request to test. Requests only go to this site's API; the URL is locked and cannot be changed, and your current login cookie is included.

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

Locked to this site

tokenstringRequired

User API token

udidstringRequired

Device UDID. Length must be 25 or 40 characters

warrantystring

Warranty type: 0/1/2/3/4/6. Recommended to pass explicitly

shtypestring

Alias of warranty. Used only when warranty is empty

typestring

Pool type: 0=shared, 1=dedicated. Default is 0

deviceTypestring

Device type: iphone or ipad. Default is iphone

beizhustring

Remark. Up to 40 characters