> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

> POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

# POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

Baixa vários arquivos de vários usuários com o mesmo nome de arquivo. O arquivo a ser baixado é determinado pelo URI da solicitação. O corpo da solicitação contém a lista de XUIDs dos usuários cujos arquivos devem ser baixados. O corpo da resposta será uma mensagem MIME de várias partes, com cada parte representando um arquivo de um usuário específico com seu próprio conjunto de cabeçalhos. É possível que as partes da resposta sejam uma combinação de êxitos e falhas.
O domínio desses URIs é `titlestorage.xboxlive.com`.

* [Parâmetros de URI](#ID4EX)
* [Autorização](#ID4ECB)
* [Corpo da solicitação](#ID4EPB)
* [Códigos de status HTTP](#ID4E3C)
* [Cabeçalhos de resposta obrigatórios](#ID4EPAAC)
* [Cabeçalhos de resposta opcionais](#ID4ESBAC)
* [Corpo da resposta](#ID4E3CAC)

<a id="ID4EX" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| scid | guid | a ID da configuração de serviço a ser consultada. |
| pathAndFileName | string | Caminho e nome de arquivo do item a ser acessado. Os caracteres válidos para a parte do caminho (até a barra final, inclusive) incluem letras maiúsculas (A-Z), letras minúsculas (a-z), números (0-9), sublinhado (*) e barra (/). A parte do caminho pode estar vazia. Os caracteres válidos para a parte do nome de arquivo (tudo após a barra final) incluem letras maiúsculas (A-Z), letras minúsculas (a-z), números (0-9), sublinhado (*), ponto (.) e hífen (-). O nome de arquivo não pode estar vazio, terminar com um ponto nem conter dois pontos consecutivos. |

<a id="ID4ECB" />

## Autorização

A solicitação deve incluir um cabeçalho de autorização do XBOX LIVE válido. Se o chamador não tiver permissão para acessar esse recurso, o serviço retornará uma resposta 403 Forbidden. Se o cabeçalho for inválido ou estiver ausente, o serviço retornará uma resposta 401 Unauthorized.

<a id="ID4EPB" />

## Corpo da solicitação

\| Propriedade| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- |
\| xuids| matriz de inteiros de 64 bits sem sinal| A lista de XUIDs para os quais baixar arquivos.|

<a id="ID4EQC" />

### Exemplo de solicitação

```cpp theme={null}
{
    "xuids" : 
    [
      12345,
      45678,
      78901
    ]
}
      
```

<a id="ID4E3C" />

## Códigos de status HTTP

O serviço retorna um dos códigos de status desta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com o XBOX Live Services, consulte [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes).

\| Código| Frase de motivo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK | A solicitação foi bem-sucedida.|
\| 201| Created | A entidade foi criada.|
\| 400| Bad Request | O serviço não conseguiu entender a solicitação malformada. Normalmente, um parâmetro inválido.|
\| 401| Unauthorized | A solicitação requer autenticação do usuário.|
\| 403| Forbidden | A solicitação não é permitida para o usuário ou serviço.|
\| 404| Not Found | O recurso especificado não foi encontrado.|
\| 406| Not Acceptable | A versão do recurso não é compatível.|
\| 408| Request Timeout | A solicitação demorou muito para ser concluída.|
\| 500| Internal Server Error | O servidor encontrou uma condição inesperada que o impediu de atender à solicitação.|
\| 503| Service Unavailable | A solicitação foi limitada; tente a solicitação novamente após o valor de nova tentativa do cliente, em segundos (por exemplo, 5 segundos depois).|

<a id="ID4EPAAC" />

## Cabeçalhos de resposta obrigatórios

\| Cabeçalho| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Disposition| Descreve o conteúdo da parte. As partes "name" e "filename" do cabeçalho são o XUID do usuário ao qual este arquivo pertence.|
\| HttpStatusCode| O código de status HTTP relacionado à recuperação deste arquivo específico.|

<a id="ID4ESBAC" />

## Cabeçalhos de resposta opcionais

\| Cabeçalho| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| ETag| ETag é um identificador opaco atribuído por um servidor Web a uma versão específica de um recurso encontrado em uma URL. Se o conteúdo do recurso nessa URL mudar, uma nova ETag diferente será atribuída.|
\| Content-Type| Se o arquivo tiver sido recuperado com êxito, este será o Content-Type do arquivo.|
\| Content-Range| Se o arquivo tiver sido recuperado com êxito e for um download parcial, este será o intervalo de bytes do arquivo contido na resposta. |

<a id="ID4E3CAC" />

## Corpo da resposta

Se a chamada for bem-sucedida, o serviço retornará o conteúdo dos arquivos solicitados em uma resposta de várias partes.

<a id="ID4EGDAC" />

### Exemplo de resposta

```cpp theme={null}
HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: multipart/form-data; boundary=c0a9fd75-d036-4294-8b7b-85fea15a31bb

228
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="123"; filename="123"
HttpStatusCode: 200
ETag: 0x8CF327717411C31
Content-Type: application/octet-stream

asdf123
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="456"; filename="456"
HttpStatusCode: 200
ETag: 0x8CF32771E954BB8
Content-Type: application/octet-stream

asdf456
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="789"; filename="789"
HttpStatusCode: 404


--c0a9fd75-d036-4294-8b7b-85fea15a31bb--

0

```

<a id="ID4EUDAC" />

## Confira também

<a id="ID4EWDAC" />

##### Pai

[/json/users/batch/scids/{scid}/data/{pathAndFileName},json](/pt-BR/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype)


## Related topics

- [XblTitleStorageBlobMetadata](/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata.md)
- [XblTitleStorageDownloadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [XblTitleStorageDeleteBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedeleteblobasync.md)
