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

# GET (/sessions/{sessionId}/scids/{scid}/data/{path})

> GET (/sessions/{sessionId}/scids/{scid}/data/{path})

# GET (/sessions/{sessionId}/scids/{scid}/data/{path})

Lista informações de arquivos em um caminho especificado.
O domínio desses URIs é `titlestorage.xboxlive.com`.

* [Parâmetros de URI](#ID4EX)
* [Parâmetros opcionais da cadeia de caracteres de consulta](#ID4ECB)
* [Autorização](#ID4EWC)
* [Cabeçalhos de solicitação obrigatórios](#ID4EDD)
* [Corpo da solicitação](#ID4EME)
* [Códigos de status HTTP](#ID4EZE)
* [Corpo da resposta](#ID4EUBAC)

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| sessionId | string | o ID da sessão a ser consultada. |
| scid | guid | O ID da configuração de serviço a ser consultada. |
| path | string | O caminho para os itens de dados a serem retornados. Todos os diretórios e subdiretórios correspondentes são retornados. Os caracteres válidos incluem letras maiúsculas (A-Z), letras minúsculas (a-z), números (0-9), sublinhado (\_) e barra (/). Pode estar vazio. Comprimento máximo de 256. |

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

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- |
\| skipItems| int| Retorna os itens a partir de N+1 na coleção, ou seja, ignora N itens.|
\| continuationToken| string| Retorna os itens a partir do token de continuação fornecido. O parâmetro continuationToken tem precedência sobre skipItems se ambos forem fornecidos. Em outras palavras, o parâmetro skipItems será ignorado se o parâmetro continuationToken estiver presente.|
\| maxItems| int| Número máximo de itens a serem retornados da coleção, que pode ser combinado com skipItems e continuationToken para retornar um intervalo de itens. O serviço pode fornecer um valor padrão se maxItems não estiver presente e pode retornar menos que maxItems, mesmo que a última página de resultados ainda não tenha sido retornada. |

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

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

## 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](https://docs.xbox.com/pt-BR/reference/live/rest/additional/httpstatuscodes.md).

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

## Corpo da resposta

Se a chamada for bem-sucedida, o serviço retornará uma matriz de objetos [TitleBlob](https://docs.xbox.com/pt-BR/reference/live/rest/json/json-titleblob.md) objects.

### Exemplo de resposta

```cpp theme={null}
{
"blobs":
[
    {
        "fileName":"foo\bar\blob.txt,binary",
        "clientFileTime":"2012-01-01T01:02:03.1234567Z",
        "displayName":"Friendly Name",
        "size":12,
        "etag":"0x8CEB3E4F8F3A5BF"
    },
    {
        "fileName":"foo\bar\blob2.txt,binary",
        "displayName":"Blob 2",
        "size":4,
        "etag":"0x8CEB3FE57F1A142"
    },
    {
        "fileName":"foo\jsonblob.txt,json",
        "size":15,
        "etag":"0x8CEB40152B4A6F8"
    }
],
"pagingInfo":
    {
        "continuationToken":"54",
    }
}
         
```

## Confira também

##### Pai

[/sessions/{sessionId}/scids/{scid}/data/{path}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/storage/uri-sessionssessionidscidssciddatapath.md)

##### Referência  [TitleBlob (JSON)](https://docs.xbox.com/pt-BR/reference/live/rest/json/json-titleblob.md)

[PagingInfo (JSON)](https://docs.xbox.com/pt-BR/reference/live/rest/json/json-paginginfo.md)


## Related topics

- [/sessions/{sessionId}/scids/{scid}/data/{path}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/storage/uri-sessionssessionidscidssciddatapath.md)
- [GET (/sessions/{sessionId}/scids/{scid}/data/{pathAndFileName},{type})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/storage/uri-sessionssessionidscidssciddatapathandfilenametype-get.md)
- [/sessions/{sessionId}/scids/{scid}/data/{pathAndFileName},{type}](https://docs.xbox.com/pt-BR/reference/live/rest/uri/storage/uri-sessionssessionidscidssciddatapathandfilenametype.md)
- [DELETE (/sessions/{sessionId}/scids/{scid}/data/{pathAndFileName},{type})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/storage/uri-sessionssessionidscidssciddatapathandfilenametype-delete.md)
- [PUT (/sessions/{sessionId}/scids/{scid}/data/{pathAndFileName},{type})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/storage/uri-sessionssessionidscidssciddatapathandfilenametype-put.md)
