POST

v2.2.0stable

Toplu Cihaz Ekle

Esnek varsayılanlar ve öğe başına geçersiz kılmalarla birden fazla UDID toplu olarak kaydet. Her öğe anında veya rezervasyon modunu kullanabilir.

POST/api/adddevice/batch

Yetkilendirme:API Key

Limit:10/dakika

İstek Parametreleri

Tüm parametreler Sorgu veya Gövde üzerinden iletilebilir

Parametre	Tür	Gerekli	Açıklama
`token`	string	İsteğe bağlı	Küresel kullanıcı API belirteci. item/defaults belirteç sağlamadığında kullanılır Örnek: your_api_token_here
`mode`	string	İsteğe bağlı	Küresel ekleme modu: anında veya inceleme. Varsayılan anındadır; defaults.mode veya item.mode tarafından değiştirilebilir instantreview Örnek: instant
`defaults`	object	İsteğe bağlı	Tüm öğeler için varsayılan parametreler. warranty/shtype/type/deviceType/beizhu/code/token/mode gibi tek ekleme API parametrelerini destekler Örnek: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	İsteğe bağlı	Cihaz öğesi dizisi. Her öğe UDID gerektirir ve herhangi bir varsayılan alanı geçersiz kılabilir. En az bir tane sağlayın: items/udids/udids_text Örnek: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	İsteğe bağlı	Basitleştirilmiş UDID dizisi. Tüm cihazlar için varsayılan/evrensel parametreleri kullanır Örnek: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	İsteğe bağlı	Virgül, noktalı virgül, boşluk veya yeni satırlarla ayrılmış metin UDID listesi Örnek: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	İsteğe bağlı	Bir öğe başarısız olursa devam edilip edilmeyeceği. Varsayılan true Örnek: true

Yanıt

Parametre	Tür	Gerekli	Açıklama
`code`	number	Gerekli	Durum kodu: 1=toplu talep işlendi Örnek: 1
`data.total`	number	Gerekli	Toplam talep edilen cihazlar Örnek: 2
`data.processed`	number	Gerekli	Aslında işlenen öğe sayısı Örnek: 2
`data.success`	number	Gerekli	Başarı sayısı Örnek: 1
`data.failed`	number	Gerekli	Başarısızlık sayısı Örnek: 1
`data.results`	array	Gerekli	Öğeye özel sonuçlar indeks/UDID/mod/başarı/kod/mesaj/veri/ham ile Örnek:

Yanıt Örneği

{

"code":1,

"msg":"Toplu istek işlendi",

"time":1769675945,

"data":

{

"total":2,

"processed":2,

"success":1,

"failed":1,

"continueOnError":true,

"results":

[

{

"index":0,

"udid":"00008030-001234567890ABCD",

"mode":"instant",

"success":true,

"code":1,

"msg":"添加成功",

"http_status":200,

"data":

{

"id":"AB12CD34",

"pool":0,

"addtime":1706500000,

"mobileprovision":"MIIPhgYJKoZIhvcNAQcCoII...(Base64)",

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

}

{

"index":1,

"udid":"invalid-udid",

"mode":"review",

"success":false,

"code":0,

"msg":"UDID格式错误",

"http_status":200

}

]

}

Hata Kodları

Hata Kodları3 tanımlandı

0

Geçersiz JSON gövdesi

İstek gövdesi geçerli JSON değil

0

items veya udids gerekli

Cihaz sağlanmadı

0

Çok fazla öğe, maksimum 50

Toplu işleme maksimum 50 cihaz

X-Lang: en

zh, en, zh-TW, vi, ar

Kod Örnekleri

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/adddevice/batch" \
  -H "X-Lang: en" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_api_token_here",
    "mode": "instant",
    "defaults": "{\"warranty\":\"1\",\"type\":\"0\",\"deviceType\":\"iphone\",\"beizhu\":\"batch\"}",
    "items": "[{\"udid\":\"00008030-001234567890ABCD\"},{\"udid\":\"00008020-00ABCDEF12345678\",\"mode\":\"review\",\"warranty\":\"2\",\"beizhu\":\"VIP device\"}]",
    "udids": "[\"00008030-001234567890ABCD\",\"00008020-00ABCDEF12345678\"]",
    "udids_text": "00008030-001234567890ABCD\n00008020-00ABCDEF12345678",
    "continue_on_error": true
  }'

Notlar

Bu uç nokta /API/adddevice ve /API/addyydevice iş mantığını yeniden kullanır ve öğeleri tek tek işler
İstek gövdesi JSON olmalıdır. Öğeye özel parametreler dahili olarak form parametrelerine dönüştürülür
Varsayılanlar paylaşılan parametreleri sağlar; öğe alanlarının önceliği daha yüksektir
Mod, instant/review destekler; reservation/reserve/yy/addyydevice review için takma adlardır
İstek başına maksimum 50 öğe, dakika başına 10 istek ile sınırlıdır

Konsolda deneyin

Aşağıdaki parametreleri doldurun ve testi yapmak için bir istek gönderin. İstekler yalnızca bu sitenin API'sine gider; URL kilitli ve değiştirilemez, mevcut giriş çereziniz dahil edilir.

POSThttps://testypro.iwai.cc/api/adddevice/batchBu siteye kilitli

tokenstring

Küresel kullanıcı API belirteci. item/defaults belirteç sağlamadığında kullanılır

modestring

Küresel ekleme modu: anında veya inceleme. Varsayılan anındadır; defaults.mode veya item.mode tarafından değiştirilebilir

defaultsobject

Tüm öğeler için varsayılan parametreler. warranty/shtype/type/deviceType/beizhu/code/token/mode gibi tek ekleme API parametrelerini destekler

itemsarray

Cihaz öğesi dizisi. Her öğe UDID gerektirir ve herhangi bir varsayılan alanı geçersiz kılabilir. En az bir tane sağlayın: items/udids/udids_text

udidsarray

Basitleştirilmiş UDID dizisi. Tüm cihazlar için varsayılan/evrensel parametreleri kullanır

udids_textstring

Virgül, noktalı virgül, boşluk veya yeni satırlarla ayrılmış metin UDID listesi

continue_on_errorboolean

Bir öğe başarısız olursa devam edilip edilmeyeceği. Varsayılan true