GETPOST
v2.1.0stable

Add Device (Review/Reservation)

Register a device in reservation mode. mobileprovision may be empty while Apple review is pending

GET | POST/api/addyydevice
Auth:API Key
Limite:30/minute

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

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

Risposta

ParametroTipoObbligoDescrizione
code
numberObbligo
Status code: 1=success, 0=failure
Esempio: 1
msg
stringObbligo
Response message
Esempio: 添加成功
time
numberObbligo
Server timestamp (Unix seconds)
Esempio: 1769675945
data
objectObbligo
Response payload
data.id
stringObbligo
Reservation order / certificate ID (typically 5 alphanumeric characters)
Esempio: A1B2C
data.pool
numberObbligo
Pool: 0=shared, 1=dedicated
Esempio: 0
data.addtime
numberObbligo
Added time (Unix)
Esempio: 1706500000
data.mobileprovision
stringObbligo
Base64-encoded mobileprovision (may be empty while review is pending)
Esempio: Base64EncodedString...
data.p12
stringObbligo
Base64-encoded P12 certificate
Esempio: Base64EncodedString...
data.state
booleanObbligo
Certificate validity state (returned in some branches)
Esempio: true
ysucc
stringObbligo
Success flag, returns "Ysucc" on success
Esempio: Ysucc
Esempio di risposta
{
"code":1,
"msg":"Reservation successful",
"time":1769675945,
"data":
{
"id":"A1B2C",
"pool":0,
"addtime":1706500000,
"mobileprovision":"",
"p12":"MIINDgIBAzCCDMsGCSqGSIb3DQEHAa...(Base64)"
}
,
"ysucc":"Ysucc"
}

Codici di errore

Codici di errore4 definito
0
Invalid token
Invalid or expired token
0
Invalid UDID format
UDID length must be 25 or 40 characters
0
Insufficient balance
Insufficient balance

Lingua di risposta

Personalizza il linguaggio di risposta API con l'intestazione X-Lang. Gli esempi di codice qui sotto utilizzano automaticamente la lingua del tuo sito corrente.

Intestazione consigliata
X-Lang: it
Lingue supportate
zh, en, zh-TW, vi, ar, es, ru

Accetta-Language è anche supportato; X-Lang prende la priorità.

Esempi di codice

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

Note

  • 参数需通过 Query 或 x-www-form-urlencoded 传递,后端不解析 JSON Body
  • shtype 为 warranty 的兼容参数,仅在 warranty 为空时使用
  • mobileprovision 为空通常表示审核中,可通过设备列表接口查询状态

Provalo in Console

Compila i parametri qui sotto e invia una richiesta al test. Le richieste vanno solo all'API di questo sito; l'URL è bloccato e non può essere modificato e il cookie di login corrente è incluso.

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%87Bloccato a questo sito
stringObbligo

User API token

stringObbligo

Device UDID. Length must be 25 or 40 characters

string

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

string

Alias of warranty. Used only when warranty is empty

string

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

string

Device type: iphone or ipad. Default is iphone

string

Remark. Up to 40 characters