Skip to main content

​
PUT (/sessions//scids//data/,)

Carrega um arquivo. Os dados podem ser carregados em um carregamento completo, no qual os dados e os metadados são enviados em uma única mensagem, ou como um carregamento de vários blocos, no qual os dados e os metadados são enviados em uma série de blocos menores. Somente arquivos menores que quatro megabytes podem ser enviados como uma única mensagem. Não há suporte para carregamento de vários blocos para dados do tipo json. 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

Para carregamentos de mensagem única, os parâmetros da cadeia de caracteres de consulta são: | Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| Data/hora do arquivo no cliente que carregou o arquivo pela última vez.| | displayName| string| Nome do arquivo que deve ser mostrado ao usuário.| Para carregamentos de vários blocos, os parâmetros da cadeia de caracteres de consulta são: | Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| Data/hora do arquivo no cliente que carregou o arquivo pela última vez.| | displayName| string| Nome do arquivo que deve ser mostrado ao usuário.| | continuationToken| string| O token de continuação da resposta da solicitação de carregamento anterior. Se este for o primeiro bloco, ele não deve ser especificado. | | finalBlock| bool| Defina como true para o último bloco do arquivo. Defina como false para todos os outros blocos.|

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

​
Corpo da solicitação

O corpo da solicitação contém o conteúdo do arquivo que está sendo carregado. Para carregamentos de mensagem única, o corpo é o conteúdo completo do arquivo. Para carregamentos de vários blocos, o corpo é a parte do arquivo especificada nos parâmetros da cadeia de caracteres de consulta.

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

​
Corpo da resposta

Se a chamada for uma solicitação de vários blocos e for bem-sucedida, o serviço retornará um token de continuação a ser passado com o próximo bloco.

​
Exemplo de resposta

​
Confira também

Pai
/sessions//scids//data/,
Last modified on October 6, 2026