Skip to main content

PUT (/json/users/xuid()/scids//data/,json)

Carrega um arquivo. 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

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

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 completo do arquivo que está sendo carregado.

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 o carregamento for bem-sucedido, um 201 será retornado com uma resposta .

Confira também

Pai
/json/users/xuid()/scids//data/,json
Last modified on October 6, 2026