Valores retornados

Código de status

Depois de 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ódigos de status.

Se o código de status 201 for retornado para a chamada da API para obtenção de 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 obtenção de 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 das outras API.

Figura 1 Cabeçalho da resposta à solicitação para obter um token de usuário

Corpo da resposta

Um corpo de resposta geralmente é retornado em um formato estruturado, correspondendo ao Content-Type no cabeçalho da resposta, e é usado para transferir conteúdo diferente do cabeçalho da resposta.

A seguir, mostramos parte do corpo da resposta da API para obter um token de usuário.

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

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": {
        "code": "111400060",
        "message": "instance name exists."
    }
}

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