POST
v2.2.0stableデバイス一括追加
柔軟なデフォルトとアイテムごとのオーバーライドを使用して、複数のUDIDを一括登録します。各アイテムは、インスタントモードまたは予約モードを使用できます。
POST
/api/adddevice/batchauth:API Key
制限:10/分
リクエストパラメータ
すべてのパラメータは、クエリまたは本文を介して渡すことができます
| パラメーター | タイプ | 必須 | 内容 |
|---|---|---|---|
token | string | オプション | グローバルユーザーAPIトークン。アイテム/デフォルトがトークンを提供していない場合に使用されます 例: your_api_token_here |
mode | string | オプション | グローバル追加モード：インスタントまたはレビュー。デフォルトはインスタントです。defaults.modeまたはitem.modeで上書きできます instantreview 例: instant |
defaults | object | オプション | すべてのアイテムのデフォルトパラメータ。保証/shtype/type/deviceType/beizhu/code/token/modeなどの単一追加APIパラメータをサポート 例: {"warranty":"1","type":"0","deviceType":"iphone","beizhu":"batch"} |
items | array | オプション | デバイス項目配列。各項目にはUDIDが必要で、任意のデフォルトフィールドを上書きできます。/udids/udids_text項目の少なくとも1つを入力してください 例: [{"udid":"00008030-001234567890ABCD"},{"udid":"00008020-00ABCDEF12345678","mode":"review","warranty":"2","beizhu":"VIP device"}] |
udids | array | オプション | 簡略化されたUDID配列。すべてのデバイスにデフォルト/グローバルパラメータを使用します 例: ["00008030-001234567890ABCD","00008020-00ABCDEF12345678"] |
udids_text | string | オプション | カンマ、セミコロン、空白、または改行で区切られたテキストUDIDリスト 例: 00008030-001234567890ABCD
00008020-00ABCDEF12345678 |
continue_on_error | boolean | オプション | アイテムが失敗した後に続行するかどうか。デフォルトはtrue 例: true |
回答
| パラメーター | タイプ | 必須 | 内容 |
|---|---|---|---|
code | number | 必須 | ステータスコード： 1 =バッチリクエストが処理されました 例: 1 |
data.total | number | 必須 | 要求されたデバイスの合計 例: 2 |
data.processed | number | 必須 | 実際に処理された品目数 例: 2 |
data.success | number | 必須 | 成功カウント: 例: 1 |
data.failed | number | 必須 | 失敗数 例: 1 |
data.results | array | 必須 | インデックス/UDID/mode/success/code/msg/data/rawのアイテムごとの結果 例: |
応答例
{}
"code":1,
"msg":"バッチリクエストが処理されました",
"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
エラーコード
エラーコード3 defined
0無効な JSON
要求本文は有効なJSONではありません
0アイテムまたはudidsが必要です
デバイスが提供されていません
0アイテムが多すぎます。最大50個です
バッチあたり最大50個のデバイス
X-Lang: enzh, en, zh-TW, vi, arコード例
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
}'注
- このエンドポイントは、/API/adddeviceと/API/addyydeviceのビジネスロジックを再利用し、アイテムを1つずつ処理します
- 要求本文はJSONでなければなりません。アイテムごとのパラメータは、内部的にフォームパラメータに変換されます
- デフォルトは共有パラメータを提供します。アイテムフィールドはより高い優先順位を持っています
- モードはインスタント/レビューをサポートしています。予約/予約/yy/addyydeviceはレビュー用のエイリアスです
- リクエストごとに最大50アイテム、レートは1分あたり10リクエストに制限されています
コンソールでお試しください
以下のパラメータを入力し、テストのリクエストを送信します。リクエストはこのサイトのAPIにのみ行きます。URLはロックされており、変更することはできません。現在のログインCookieが含まれています。
POST
https://testypro.iwai.cc/api/adddevice/batchこのサイトにロックされていますstring
グローバルユーザーAPIトークン。アイテム/デフォルトがトークンを提供していない場合に使用されます
string
グローバル追加モード：インスタントまたはレビュー。デフォルトはインスタントです。defaults.modeまたはitem.modeで上書きできます
object
すべてのアイテムのデフォルトパラメータ。保証/shtype/type/deviceType/beizhu/code/token/modeなどの単一追加APIパラメータをサポート
array
デバイス項目配列。各項目にはUDIDが必要で、任意のデフォルトフィールドを上書きできます。/udids/udids_text項目の少なくとも1つを入力してください
array
簡略化されたUDID配列。すべてのデバイスにデフォルト/グローバルパラメータを使用します
string
カンマ、セミコロン、空白、または改行で区切られたテキストUDIDリスト
boolean
アイテムが失敗した後に続行するかどうか。デフォルトはtrue