複数の API 呼び出しを 1 つのリクエストにまとめて、効率を向上させます。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST /v2/batch HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| domain_id |
string |
必須 |
||
| body |
object |
任意 |
リクエストボディのパラメーターを含みます。 |
|
| resource |
string |
必須 |
サブリクエストのリソースタイプです。サポートされるリソースタイプは以下のとおりです。
列挙値:
|
file |
| requests |
array<object> |
必須 |
サブリクエストのコレクションです。 バッチリクエストには、1 ~ 100 個のサブリクエストを含めることができます。 |
|
|
array<object> |
任意 |
サブリクエストオブジェクトです。 |
||
| id |
string |
必須 |
サブリクエストの一意な ID です。この ID は、サブリクエストとその応答を関連付けるために使用されます。ID はバッチリクエスト内で一意である必要があります。 |
93433894994ad2e1 |
| method |
string |
必須 |
サブリクエストの HTTP メソッドです。サポートされるメソッドは以下のとおりです。
列挙値:
|
POST |
| url |
string |
必須 |
サブリクエストの API パスです。サポートされるパスは以下のとおりです。
列挙値:
|
/file/get |
| body |
object |
任意 |
サブリクエストのリクエストボディです。詳細については、特定の API オペレーションのドキュメントをご参照ください。
|
|
|
any |
任意 |
サブリクエストのリクエストボディです。 |
{"domain_id":"1","drive_id":"1"} |
|
| headers |
object |
任意 |
サブリクエストのリクエストヘッダーです。 |
|
|
string |
任意 |
サブリクエストのリクエストヘッダーです。 |
{"Content-Type":"application/json"} |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーターです。 |
||
| responses |
array<object> |
サブリクエストへの応答のコレクションです。 |
|
|
array<object> |
単一のサブリクエストに対する応答オブジェクトです。 |
||
| id |
string |
この応答に対応するサブリクエストの ID です。 |
93433894994ad2e1 |
| status |
integer |
サブリクエストの HTTP ステータスコードです。詳細については、特定の API オペレーションのドキュメントをご参照ください。 |
200 |
| body |
object |
サブリクエストのレスポンスボディです。詳細については、特定の API オペレーションのドキュメントをご参照ください。 |
|
|
any |
サブリクエストのレスポンスボディです。 |
{"domain_id":"1","drive_id":"1","file_id":"9520943DC264"} |
例
成功レスポンス
JSONJSON
{
"responses": [
{
"id": "93433894994ad2e1",
"status": 200,
"body": {
"key": "{\"domain_id\":\"1\",\"drive_id\":\"1\",\"file_id\":\"9520943DC264\"}"
}
}
]
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。