Skip to main content

​
GET (/json/users/xuid()/scids//data/,json)

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

​
Parâmetros de URI

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

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

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

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

​
Corpo da solicitação

Nenhum objeto é enviado no corpo desta 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 os 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 | 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).|

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

​
Corpo da resposta

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

​
Confira também

Pai
/json/users/xuid()/scids//data/,json
Referência TitleBlob (JSON)
Last modified on October 6, 2026