POST

v2.2.0stable

Ajouter des Appareils en Lot

Enregistrer par lots plusieurs UDID avec des valeurs par défaut flexibles et des remplacements par élément. Chaque élément peut utiliser le mode instantané ou le mode réservation.

POST/api/adddevice/batch

Authentification:API Key

Limite:10/minute

Paramètres de la requête

Tous les paramètres peuvent être transmis via Query ou Body

Paramètre	Type	Requis	Description
`token`	string	Optionnel	Jeton API utilisateur global. Utilisé lorsque item/defaults ne fournit pas de jeton Exemple: your_api_token_here
`mode`	string	Optionnel	Mode d'ajout global : instantané ou révision. La valeur par défaut est instantanée ; peut être remplacée par defaults.mode ou item.mode instantreview Exemple: instant
`defaults`	object	Optionnel	Paramètres par défaut pour tous les articles. Prend en charge les paramètres API d'ajout unique tels que warranty/shtype/type/deviceType/beizhu/code/token/mode Exemple: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"}
`items`	array	Optionnel	Tableau d'éléments de périphérique. Chaque élément nécessite un UDID et peut remplacer n'importe quel champ par défaut. Fournir au moins un des éléments items/udids/udids_text Exemple: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}]
`udids`	array	Optionnel	Tableau UDID simplifié. Utilise les paramètres par défaut/globaux pour tous les périphériques Exemple: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"]
`udids_text`	string	Optionnel	Liste UDID en texte séparée par des virgules, des points-virgules, des espaces ou des sauts de ligne Exemple: 00008030-001234567890ABCD 00008020-00ABCDEF12345678
`continue_on_error`	boolean	Optionnel	Indique si le processus doit continuer après l'échec d'un élément. Par défaut vrai Exemple: true

Réponse

Paramètre	Type	Requis	Description
`code`	number	Requis	Code de statut : 1=requête par lot traitée Exemple: 1
`data.total`	number	Requis	Nombre total de périphériques demandés Exemple: 2
`data.processed`	number	Requis	Nombre d'articles réellement traités Exemple: 2
`data.success`	number	Requis	Nombre de réussites Exemple: 1
`data.failed`	number	Requis	Nombre d'échecs Exemple: 1
`data.results`	array	Requis	Résultats par article avec index/UDID/mode/success/code/msg/data/raw Exemple:

Exemple de réponse

{

"code":1,

"msg":"Requête par lot traitée",

"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

}

]

}

Codes d'erreur

Codes d'erreur3 défini

0

Corps JSON invalide

Le corps de la requête n'est pas un JSON valide

0

items ou udids sont requis

Aucun appareil fourni

0

Trop d'articles, le maximum est de 50

Maximum 50 appareils par lot

X-Lang: en

zh, en, zh-TW, vi, ar

Exemples de code

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

Remarques

Ce point de terminaison réutilise la logique métier de /API/adddevice et /API/addyydevice et traite les éléments un par un
Le corps de la requête doit être au format JSON. Les paramètres par élément sont convertis en paramètres de formulaire en interne
les valeurs par défaut fournissent des paramètres partagés ; les champs de l'élément ont une priorité plus élevée
le mode prend en charge instantané/revue ; reservation/reserve/yy/addyydevice sont des alias pour revue
Maximum 50 éléments par requête, limité à 10 requêtes/minute

Essayez-le dans la Console

Remplissez les paramètres ci-dessous et envoyez une requête pour tester. Les requêtes ne vont qu'à l'API de ce site ; l'URL est verrouillée et ne peut pas être modifiée, et votre cookie de connexion actuel est inclus.

POSThttps://testypro.iwai.cc/api/adddevice/batchVerrouillé sur ce site

tokenstring

Jeton API utilisateur global. Utilisé lorsque item/defaults ne fournit pas de jeton

modestring

Mode d'ajout global : instantané ou révision. La valeur par défaut est instantanée ; peut être remplacée par defaults.mode ou item.mode

defaultsobject

Paramètres par défaut pour tous les articles. Prend en charge les paramètres API d'ajout unique tels que warranty/shtype/type/deviceType/beizhu/code/token/mode

itemsarray

Tableau d'éléments de périphérique. Chaque élément nécessite un UDID et peut remplacer n'importe quel champ par défaut. Fournir au moins un des éléments items/udids/udids_text

udidsarray

Tableau UDID simplifié. Utilise les paramètres par défaut/globaux pour tous les périphériques

udids_textstring

Liste UDID en texte séparée par des virgules, des points-virgules, des espaces ou des sauts de ligne

continue_on_errorboolean

Indique si le processus doit continuer après l'échec d'un élément. Par défaut vrai