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

# GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

> GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

# GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

Baixa um arquivo.
O domínio desses URIs é `titlestorage.xboxlive.com`.

* [Parâmetros de URI](#ID4EX)
* [Autorização](#ID4ECB)
* [Parâmetros opcionais da cadeia de caracteres de consulta](#ID4EPB)
* [Cabeçalhos de solicitação obrigatórios](#ID4EQC)
* [Cabeçalhos de solicitação opcionais](#ID4EZD)
* [Corpo da solicitação](#ID4EDF)
* [Códigos de status HTTP](#ID4EQF)
* [Cabeçalhos de resposta](#ID4EDDAC)
* [Corpo da resposta](#ID4EGEAC)

<a id="ID4EX" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| xuid | inteiro sem sinal de 64 bits | O ID de usuário do XBOX (XUID) do jogador que está fazendo a solicitação. |
| scid | guid | o 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 do 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 do arquivo não pode estar vazio, terminar com ponto ou 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 este 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" />

## Parâmetros opcionais da cadeia de caracteres de consulta

Varia de acordo com o tipo de blob. Blobs binários não dão suporte a parâmetros de consulta.

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- |
\| select| string| Utilizável somente quando o tipo é json. Especifica que a resposta deve conter apenas uma determinada propriedade/valor do JSON, conforme determinado por este parâmetro. Use um "ponto" (.) para especificar subpropriedades e colchetes ('\[' e ']') para especificar índices de matriz. Por exemplo, "array1\[4].prop2" especifica a propriedade "prop2" do índice 4 da matriz "array1".|

<a id="ID4EQC" />

## Cabeçalhos de solicitação obrigatórios

\| Cabeçalho| Valor| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 1| Versão do contrato de API.|
\| Authorization| XBL3.0 x=\[hash];\[token]| Token de autenticação STS. STSTokenString é substituído pelo token retornado pela solicitação de autenticação. Consulte Autenticação e autorização de solicitações dos XBOX LIVE Services para obter informações adicionais sobre como recuperar um token STS e criar um cabeçalho de autorização.|

<a id="ID4EZD" />

## Cabeçalhos de solicitação opcionais

\| Cabeçalho| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| If-Match| Especifica uma ETag que deve corresponder a um item existente para concluir a operação.|
\| If-None-Match| Especifica uma ETag que não deve corresponder a nenhum item existente para concluir a operação.|
\| Range| Especifica o intervalo de bytes a ser baixado. Segue o formato padrão do cabeçalho HTTP Range.|

<a id="ID4EDF" />

## Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

<a id="ID4EQF" />

## 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 os 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 | Não há suporte para a versão do recurso.|
\| 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 novamente após o valor de client-retry em segundos (por exemplo, 5 segundos depois).|

<a id="ID4EDDAC" />

## Cabeçalhos de resposta

\| 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 ETag nova e diferente será atribuída.|
\| Content-Range| Se este foi um download parcial, este cabeçalho especifica o intervalo de bytes baixados.|

<a id="ID4EGEAC" />

## Corpo da resposta

Se a chamada for bem-sucedida, o serviço retornará o conteúdo do arquivo.

<a id="ID4EREAC" />

## Confira também

<a id="ID4ETEAC" />

##### Pai

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

<a id="ID4E6EAC" />

##### Referência  [TitleBlob (JSON)](/pt-BR/reference/live/rest/json/json-titleblob)


## Related topics

- [XblTitleStorageDownloadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [XblTitleStorageGetBlobMetadataAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataasync.md)
