POST (/json/users/batch/scids//data/,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
Autorização
Corpo da solicitação
Códigos de status HTTP
Cabeçalhos de resposta obrigatórios
Cabeçalhos de resposta opcionais
Corpo da resposta

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.

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.

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.|

Exemplo de solicitação

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. | 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).|

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.|

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. |

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.

Exemplo de resposta

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

Confira também

Pai

/json/users/batch/scids//data/,json

Porting

Build Paths

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

POST (/json/users/batch/scids//data/,json)

Parâmetros de URI

Autorização

Corpo da solicitação

Exemplo de solicitação

Códigos de status HTTP

Cabeçalhos de resposta obrigatórios

Cabeçalhos de resposta opcionais

Corpo da resposta

Exemplo de resposta

Confira também

Pai

​POST (/json/users/batch/scids//data/,json)

​Parâmetros de URI

​Autorização

​Corpo da solicitação

​Exemplo de solicitação

​Códigos de status HTTP

​Cabeçalhos de resposta obrigatórios

​Cabeçalhos de resposta opcionais

​Corpo da resposta

​Exemplo de resposta

​Confira também

Pai

POST (/json/users/batch/scids//data/,json)

Parâmetros de URI

Autorização

Corpo da solicitação

Exemplo de solicitação

Códigos de status HTTP

Cabeçalhos de resposta obrigatórios

Cabeçalhos de resposta opcionais

Corpo da resposta

Exemplo de resposta

Confira também