Respuesta
Código de estado
Después de enviar una solicitud, recibirá una respuesta, que incluye un código de estado, un encabezado de respuesta y un cuerpo de respuesta.
Un código de estado es un grupo de dígitos, que van desde 1xx hasta 5xx. Indica el estado de una solicitud. Para obtener más información, consulte Códigos de estado.
Para que la API obtenga un token de usuario, si el código de estado 201 se devuelve después de que se invoca a la API, la solicitud tiene éxito.
Encabezado de respuesta
Similar a una solicitud, una respuesta también tiene una cabecera, por ejemplo, Content-Type.
Figura 1 muestra los campos de encabezado de respuesta para la API utilizada para obtener un token de usuario. El campo de encabezado x-subject-token es el token de usuario deseado. Este token se puede utilizar para autenticar la invocación de otras API.
(Opcional) Cuerpo de respuesta
Esta parte es opcional. El cuerpo de una respuesta se devuelve a menudo en formato estructurado (por ejemplo, JSON o XML) como se especifica en el campo de encabezado Content-Type. El cuerpo de la respuesta transfiere contenido excepto el encabezado de la respuesta.
A continuación se muestra el cuerpo de respuesta de la API para obtener un token de usuario. En aras del espacio, solo una parte del contenido se muestra aquí.
{
"token": {
"expires_at": "2019-02-13T06:52:13.855000Z",
"methods": [
"password"
],
"catalog": [
{
"endpoints": [
{
"region_id": "aaa"//The region ID "aaa" is used as an example.
...
Si se produce un error durante la invocación a la API, se mostrará un código de error y un mensaje. A continuación se muestra un cuerpo de respuesta de error.
{
"error_msg": "Invalid cluster name.",
"error_code": "12000002"
}
En el cuerpo de la respuesta, error_code es un código de error y error_msg proporciona información sobre el error.
