Respuesta

Código de estado

Después de enviar una solicitud, recibe 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 respuesta. Para obtener más información, consulte Códigos de estado.

Por ejemplo, si se devuelve el código de estado 201 después de invocar a la API para obtener un token de usuario, la solicitud se realiza correctamente.

Encabezado de respuesta

Al igual que una solicitud, una respuesta también tiene un encabezado, por ejemplo, Content-Type.

Figura 1 muestra el encabezado de respuesta para la API utilizada para obtener un token de usuario. El campo x-subject-token lleva un token de usuario. Puede usar este token para autenticar la invocación a otras API.

Figura 1 Encabezado de respuesta para la API utilizada para obtener un token de usuario

Cuerpo de respuesta

Esta parte es opcional. Un cuerpo de respuesta generalmente se devuelve en un formato estructurado (por ejemplo, JSON o XML), que es especificado por Content-Type en el encabezado de respuesta. Se utiliza para transferir contenido que no sea el encabezado de respuesta.

Lo siguiente es parte de un cuerpo de respuesta para la API utilizada para obtener un token de usuario.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
    "token": {
        "expires_at": "2022-09-10T06:52:13.855000Z",
        "methods": [
            "password"
        ],
        "catalog": [
            {
                "endpoints": [
                    {
                        "region_id": "cn-north-04",
......

Si se produce un error durante la invocación a la API, se mostrará un código de error y un mensaje de error. A continuación se muestra un ejemplo de un cuerpo de respuesta de error.

1
2
3
4

{
    "error_msg": "The format of message is error",
    "error_code": "AS.0001"
}

error_code especifica un código de error y error_msg describe el error.