GETPOST
v2.1.0stable

Add Device (Instant)

Register a device UDID and return mobileprovision and P12 immediately

GET | POST/api/adddevice
Auth:API Key
Granica:60/minute

Parametry żądania

Wszystkie parametry mogą być przekazywane za pośrednictwem zapytania lub ciała

ParametrRodzajWymaganeOpis
token
stringWymagane
User API token
Przykład: your_api_token_here
udid
stringWymagane
Device UDID (must be 25 or 40 characters)
Przykład: 00008030-001234567890ABCD
warranty
stringOpcjonalnie
Warranty type: 0/1/2/3/4/6. Recommended to pass explicitly. Missing or invalid values fall back to standard for pricing
012346
Przykład: 1
shtype
stringOpcjonalnie
Alias of warranty. Used only when warranty is empty
012346
Przykład: 1
type
stringOpcjonalnie
Pool type: 0=public, 1=private. Default is 0
01
Przykład: 0
deviceType
stringOpcjonalnie
Device type: iphone or ipad. Default is iphone
iphoneipad
Przykład: iphone
beizhu
stringOpcjonalnie
Remark (up to 40 characters; truncated if longer)
Przykład: 测试设备
code
stringOpcjonalnie
Activation code (optional)
Przykład: ABC123XYZ

Odpowiedź

ParametrRodzajWymaganeOpis
code
numberWymagane
Status code: 1=success, 0=failure
Przykład: 1
msg
stringWymagane
Response message
Przykład: 添加成功
time
numberWymagane
Server timestamp (Unix seconds)
Przykład: 1769675945
data
objectWymagane
Response payload
data.id
stringWymagane
Certificate ID (8 characters)
Przykład: AB12CD34
data.pool
numberWymagane
Pool: 0=public, 1=private
Przykład: 0
data.addtime
numberWymagane
Added time (Unix)
Przykład: 1706500000
data.mobileprovision
stringWymagane
Base64-encoded mobileprovision
Przykład: Base64EncodedString...
data.p12
stringWymagane
Base64-encoded P12 certificate
Przykład: Base64EncodedString...
data.state
booleanWymagane
Certificate validity state (returned in some branches)
Przykład: true
data.reused
booleanWymagane
Whether an existing certificate was reused (returned only when code is provided and reuse is possible for the same code and UDID)
Przykład: true
ysucc
stringWymagane
Success flag, returns "Ysucc" on success
Przykład: Ysucc
Przykład odpowiedzi
{
"code":1,
"msg":"Device added successfully",
"time":1769675945,
"data":
{
"id":"AB12CD34",
"pool":0,
"addtime":1706500000,
"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Kod błędu

Kod błędu5 zdefiniowane
0
Invalid token
Invalid or expired token
0
Invalid UDID format
UDID length must be 25 or 40 characters
0
Insufficient balance
Insufficient balance (message may vary by branch)

Język odpowiedzi

Dostosuj język odpowiedzi API do nagłówka X- Lang. Poniższe przykłady kodów automatycznie korzystają z aktualnego języka strony.

Zalecany nagłówek
X-Lang: pl
Obsługiwane języki
zh, en, zh-TW, vi, ar, es, ru

Obsługiwane jest również Accept- Language; X- Lang ma pierwszeństwo. Nieobsługiwane języki podążają za zapasami języka strony.

Przykłady kodów

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

Uwagi

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

Spróbuj w konsoli

Wypełnij poniższe parametry i wyślij wniosek o przetestowanie. Żądania są kierowane tylko do API tej witryny; adres URL jest zablokowany i nie może być zmieniony, a obecne pliki cookie logowania są włączone.

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=ABC123XYZZamknięte na tej stronie
stringWymagane

User API token

stringWymagane

Device UDID (must be 25 or 40 characters)

string

Warranty type: 0/1/2/3/4/6. Recommended to pass explicitly. Missing or invalid values fall back to standard for pricing

string

Alias of warranty. Used only when warranty is empty

string

Pool type: 0=public, 1=private. Default is 0

string

Device type: iphone or ipad. Default is iphone

string

Remark (up to 40 characters; truncated if longer)

string

Activation code (optional)