Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Document Database Service> Referência de API> Chamada de APIs> Valores retornados
Atualizado em 2023-05-06 GMT+08:00
Ver PDF

Valores retornados

Código de status

Após enviar uma solicitação, você receberá uma resposta, incluindo o código de status, o cabeçalho da resposta e o corpo da resposta.

Um código de status é um grupo de dígitos que variam de 1xx a 5xx. Indica o status de uma resposta. Para obter mais informações, consulte Código de status.

Se o código de status 201 for retornado para a chamada da API para obter um token de usuário, a solicitação foi bem-sucedida.

Cabeçalho de resposta

Um cabeçalho de resposta corresponde a um cabeçalho de solicitação, por exemplo, Content-Type.

Figura 1 mostra o cabeçalho de resposta da API para obter um token de usuário, em que x-subject-token é o token do usuário desejado. Em seguida, você pode usar o token para autenticar a chamada de outras API.

Figura 1 Cabeçalho para a API usada para obter um token de usuário

(Opcional) Corpo de resposta

Esta parte é opcional. Um corpo de resposta é geralmente retornado em um formato estruturado (por exemplo, JSON ou XML), correspondente ao Content-Type no cabeçalho da resposta, e é usado para transferir conteúdo diferente do cabeçalho da resposta.

Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida. A seguir, mostramos parte do corpo da resposta da API para obter um token de usuário.

{
    "token": {
        "expires_at": "2019-02-13T06:52:13.855000Z",
        "methods": [
            "password"
        ],
        "catalog": [
            {
                "endpoints": [
                    {
                        "region_id": "aaa",
......

Se ocorrer um erro durante a chamada da API, o sistema retornará um código de erro e uma mensagem para você. A seguir, mostra o formato de um corpo de resposta de erro:

{
    "error_msg": "Parameter error",
    "error_code": "DBS.200001"
}

Nas informações anteriores, error_code é um código de erro, error_msg descreve o erro.

Tópico principal: Chamada de APIs