返回首页API 文档
语言: 简体中文
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
返回文档列表
GETPOST
v2.1.0stable

秒出添加设备

提交设备 UDID，立即返回 mobileprovision 和 P12

GET | POST/api/adddevice
认证:API Key
限流:60/分钟

请求参数

所有请求参数需通过 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
string可选
卡密（可选）
示例: ABC123XYZ

响应参数

参数名类型必填说明
code
number必填
状态码：1=成功，0=失败
示例: 1
msg
string必填
返回信息
示例: 添加成功
time
number必填
服务器时间戳（Unix 秒）
示例: 1769675945
data
object必填
业务数据
data.id
string必填
证书 ID（8 位）
示例: AB12CD34
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
data.reused
boolean必填
是否复用现有证书（仅在携带 code 且满足同一卡密同一 UDID 可复用时返回）
示例: true
ysucc
string必填
成功标识，成功时返回 "Ysucc"
示例: Ysucc
响应示例
{
"code":1,
"msg":"添加成功",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

错误码

错误码5 个定义
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/adddevice" \
  -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=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZ"

注意事项

  • 支持 GET 和 POST（示例使用 POST）
  • 参数通过 Query 或 x-www-form-urlencoded 传递，后端不解析 JSON Body
  • shtype 为 warranty 的兼容参数，仅在 warranty 为空时使用
  • UDID 仅校验长度（25 或 40）
  • mobileprovision 与 p12 为 Base64 编码，需自行解码保存
  • warranty=4 时不支持独立池（type=1）

在控制台试一试

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

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=ABC123XYZ已锁定本站
string必填

用户 API Token

string必填

设备 UDID（长度必须为 25 或 40）

string

售后类型：0=躺平版，1=标准版，2=加强版，3=稳定版，4=摆烂版，6=高摆烂版。建议显式传入；缺省或非法值在价格计算中按标准版处理

string

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

string

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

string

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

string

备注（最多 40 个字符，超出截断）

string

卡密（可选）