POST

v2.2.0stable

Geräte Stapelweise Hinzufügen

Mehrere UDIDs mit flexiblen Standardwerten und pro Artikel überschreibbaren Einstellungen registrieren. Jeder Artikel kann den Sofort- oder Reservierungsmodus verwenden.

POST/api/adddevice/batch

Authentifizierung:API Key

Begrenzung:10/Minute

Anforderungsparameter

Alle Parameter können über Query oder Body übergeben werden

Parameter	Typ	Erforderlich	Beschreibung
`token`	string	Optional	Globales Benutzer-API-Token. Wird verwendet, wenn item/defaults kein Token bereitstellen Beispiel: your_api_token_here
`mode`	string	Optional	Globaler Hinzufügungsmodus: sofort oder Überprüfung. Standard ist sofort; kann durch defaults.mode oder item.mode überschrieben werden instantreview Beispiel: instant
`defaults`	object	Optional	Standardparameter für alle Elemente. Unterstützt einzelne Add-API-Parameter wie warranty/shtype/type/deviceType/beizhu/code/token/mode Beispiel: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	Optional	Geräte-Element-Array. Jedes Element erfordert UDID und kann beliebige Standardfelder überschreiben. Mindestens eines der Elemente items/udids/udids_text angeben Beispiel: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	Optional	Vereinfachtes UDID-Array. Verwendet Standard-/Globaleinstellungen für alle Geräte Beispiel: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	Optional	UDID-Textliste, getrennt durch Komma, Semikolon, Leerzeichen oder Zeilenumbrüche Beispiel: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	Optional	Ob nach einem Fehler bei einem Element fortgesetzt werden soll. Standardwert true Beispiel: true

Antwort

Parameter	Typ	Erforderlich	Beschreibung
`code`	number	Erforderlich	Statuscode: 1=Batch-Anfrage verarbeitet Beispiel: 1
`data.total`	number	Erforderlich	Gesamtzahl der angeforderten Geräte Beispiel: 2
`data.processed`	number	Erforderlich	Tatsächlich verarbeitete Artikelanzahl Beispiel: 2
`data.success`	number	Erforderlich	Erfolgsanzahl Beispiel: 1
`data.failed`	number	Erforderlich	Fehlgeschlagene Anzahl Beispiel: 1
`data.results`	array	Erforderlich	Ergebnisse pro Artikel mit Index/UDID/Modus/Erfolg/Code/Meldung/Daten/Rohdaten Beispiel:

Antwortbeispiel

{

"code":1,

"msg":"Stapelanfrage verarbeitet",

"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

}

]

}

Fehlercodes

Fehlercodes3 definiert

0

Ungültiger JSON-Body

Anforderungs-Body ist kein gültiges JSON

0

Artikel oder UDIDs sind erforderlich

Kein Gerät angegeben

0

Zu viele Artikel, maximal sind 50

Maximal 50 Geräte pro Stapel

X-Lang: en

zh, en, zh-TW, vi, ar

Codebeispiele

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
  }'

Hinweise

Dieser Endpunkt verwendet die Geschäftslogik von /API/adddevice und /API/addyydevice wieder und verarbeitet die Elemente nacheinander
Der Anforderungskörper muss JSON sein. Die Parameter pro Element werden intern in Formularparameter umgewandelt
Standardwerte liefern gemeinsame Parameter; Elementfelder haben höhere Priorität
Der Modus unterstützt Instant/Review; reservation/reserve/yy/addyydevice sind Aliase für Review
Maximal 50 Elemente pro Anfrage, auf 10 Anfragen/Minute begrenzt

Versuchen Sie es in der Konsole

Füllen Sie die untenstehenden Parameter aus und senden Sie eine Anfrage zum Testen. Anfragen gehen nur an die API dieser Seite; die URL ist gesperrt und kann nicht geändert werden, und Ihr aktuelles Login-Cookie ist enthalten.

POSThttps://testypro.iwai.cc/api/adddevice/batchGesperrt für diese Seite

tokenstring

Globales Benutzer-API-Token. Wird verwendet, wenn item/defaults kein Token bereitstellen

modestring

Globaler Hinzufügungsmodus: sofort oder Überprüfung. Standard ist sofort; kann durch defaults.mode oder item.mode überschrieben werden

defaultsobject

Standardparameter für alle Elemente. Unterstützt einzelne Add-API-Parameter wie warranty/shtype/type/deviceType/beizhu/code/token/mode

itemsarray

Geräte-Element-Array. Jedes Element erfordert UDID und kann beliebige Standardfelder überschreiben. Mindestens eines der Elemente items/udids/udids_text angeben

udidsarray

Vereinfachtes UDID-Array. Verwendet Standard-/Globaleinstellungen für alle Geräte

udids_textstring

UDID-Textliste, getrennt durch Komma, Semikolon, Leerzeichen oder Zeilenumbrüche

continue_on_errorboolean

Ob nach einem Fehler bei einem Element fortgesetzt werden soll. Standardwert true