Add Device (Instant)
Register a device UDID and return mobileprovision and P12 immediately
/api/adddeviceRequest 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 (must be 25 or 40 characters) Example: 00008030-001234567890ABCD |
warranty | string | Optional | Warranty type: 0/1/2/3/4/6. Recommended to pass explicitly. Missing or invalid values fall back to standard for pricing 012346 Example: 1 |
shtype | string | Optional | Alias of warranty. Used only when warranty is empty 012346 Example: 1 |
type | string | Optional | Pool type: 0=public, 1=private. 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; truncated if longer) Example: 测试设备 |
code | string | Optional | Activation code (optional) Example: ABC123XYZ |
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 | Certificate ID (8 characters) Example: AB12CD34 |
data.pool | number | Required | Pool: 0=public, 1=private Example: 0 |
data.addtime | number | Required | Added time (Unix) Example: 1706500000 |
data.mobileprovision | string | Required | Base64-encoded mobileprovision 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 |
data.reused | boolean | Required | Whether an existing certificate was reused (returned only when code is provided and reuse is possible for the same code and UDID) Example: true |
ysucc | string | Required | Success flag, returns "Ysucc" on success Example: Ysucc |
Error Codes
000Response Language
Customize the API response language with the X-Lang header. The code examples below automatically use your current site language.
X-Lang: enzh, en, zh-TW, vi, arAccept-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/adddevice" \
-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=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZ"Notes
- Both GET and POST are supported (POST shown here)
- 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
- UDID validation is length-only (25 or 40 characters)
- mobileprovision and p12 are Base64 encoded; decode and save as files
- warranty=4 is not supported with type=1
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/adddevice?token=your_api_token_here&udid=00008030-001234567890ABCD&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZLocked to this siteUser API token
Device UDID (must be 25 or 40 characters)
Warranty type: 0/1/2/3/4/6. Recommended to pass explicitly. Missing or invalid values fall back to standard for pricing
Alias of warranty. Used only when warranty is empty
Pool type: 0=public, 1=private. Default is 0
Device type: iphone or ipad. Default is iphone
Remark (up to 40 characters; truncated if longer)
Activation code (optional)