Resposta
Código de estado
Depois de enviar uma solicitação, você receberá uma resposta, incluindo um código de status, cabeçalho de resposta e corpo de resposta.
Um código de estado é um grupo de dígitos, variando de 1xx a 5xx. Indica o status de uma solicitação. Para obter mais informações, consulte Códigos de estado.
Se o código de estado 201 é retornado para chamar a API usada para obter um token de usuário, a solicitação é bem-sucedida.
Cabeçalho de resposta
Semelhante a uma solicitação, uma resposta também tem um cabeçalho, por exemplo, Content-type.
Figura 1 mostra os campos de cabeçalho de resposta da API usada para obter um token de usuário. O campo de cabeçalho x-subject-token é o token de usuário desejado. Esse token pode ser usado para autenticar a chamada de outras APIs.
(Opcional) Corpo de resposta
O corpo de uma resposta geralmente é retornado em formato estruturado, conforme especificado no campo de cabeçalho Content-Type. O corpo da resposta transfere o conteúdo, exceto o cabeçalho da resposta.
A seguir está uma parte do corpo de resposta para a API usada para obter um token de usuário. Por uma questão de espaço, apenas parte do conteúdo é exibido aqui.
{
"token": {
"expires_at": "2019-02-13T06:52:13.855000Z",
"methods": [
"password"
],
"catalog": [
{
"endpoints": [
{
"region_id": "az-01",
......
Se ocorrer um erro durante a chamada da API, um código de erro e uma mensagem serão exibidos. O seguinte mostra um corpo de resposta de erro.
{
"error_msg": "The format of message is error",
"error_code": "AS.0001"
}
No corpo da resposta, error_code é um código de erro e error_msg fornece informações sobre o erro.
