Combina múltiplas chamadas de API em uma única solicitação para melhorar a eficiência.
Experimente agora
Testar
Autorização RAM
Sintaxe da solicitação
POST /v2/batch HTTP/1.1
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| domain_id |
string |
Sim |
||
| body |
object |
Não |
Contém os parâmetros do corpo da solicitação. |
|
| resource |
string |
Sim |
O tipo de recurso das sub-solicitações. Os tipos de recurso suportados incluem:
Valores válidos:
|
file |
| requests |
array<object> |
Sim |
Uma coleção de sub-solicitações. Uma solicitação em lote pode conter de 1 a 100 sub-solicitações. |
|
|
array<object> |
Não |
Um objeto de sub-solicitação. |
||
| id |
string |
Sim |
O ID exclusivo da sub-solicitação. Este ID é usado para correlacionar a sub-solicitação com sua resposta. Os IDs devem ser exclusivos dentro de uma solicitação em lote. |
93433894994ad2e1 |
| method |
string |
Sim |
O método HTTP da sub-solicitação. Os métodos suportados incluem:
Valores válidos:
|
POST |
| url |
string |
Sim |
O caminho da API da sub-solicitação. Os caminhos suportados incluem:
Valores válidos:
|
/file/get |
| body |
object |
Não |
O corpo da solicitação da sub-solicitação. Para mais detalhes, consulte a documentação da operação de API específica. Se você especificar o parâmetro |
|
|
any |
Não |
O corpo da solicitação da sub-solicitação. |
{"domain_id":"1","drive_id":"1"} |
|
| headers |
object |
Não |
Os cabeçalhos de solicitação da sub-solicitação. |
|
|
string |
Não |
Os cabeçalhos de solicitação da sub-solicitação. |
{"Content-Type":"application/json"} |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os parâmetros de resposta. |
||
| responses |
array<object> |
Uma coleção de respostas às sub-solicitações. |
|
|
array<object> |
Um objeto de resposta para uma única sub-solicitação. |
||
| id |
string |
O ID da sub-solicitação à qual esta resposta corresponde. |
93433894994ad2e1 |
| status |
integer |
O código de status HTTP da sub-solicitação. Para mais detalhes, consulte a documentação da operação de API específica. |
200 |
| body |
object |
O corpo da resposta da sub-solicitação. Para mais detalhes, consulte a documentação da operação de API específica. |
|
|
any |
O corpo da resposta da sub-solicitação. |
{"domain_id":"1","drive_id":"1","file_id":"9520943DC264"} |
Exemplos
Resposta de sucesso
JSON formato
{
"responses": [
{
"id": "93433894994ad2e1",
"status": 200,
"body": {
"key": "{\"domain_id\":\"1\",\"drive_id\":\"1\",\"file_id\":\"9520943DC264\"}"
}
}
]
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.