​

GET (/global/scids//data/,)

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

• Parâmetros de URI
• Autorização
• Parâmetros opcionais de cadeia de caracteres de consulta
• Cabeçalhos de solicitação obrigatórios
• Cabeçalhos de solicitação opcionais
• Corpo da solicitação
• Códigos de status HTTP
• Cabeçalhos de resposta
• Corpo da resposta

​

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

​

Parâmetros opcionais de 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”.| | customSelector| string| Para arquivos do tipo config. Indica quais nós virtuais personalizados incluir. Consulte Title Storage para obter mais informações sobre arquivos do tipo config.|

​

Cabeçalhos de solicitação obrigatórios

| Cabeçalho| Valor| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 1| Versão do contrato da 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 do 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 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

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

/global/scids//data/,

Referência TitleBlob (JSON)