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