Errores

En esta sección, encontrarás una visión general sobre los errores que puedes recibir en los endpoints de la plataforma Unico IDCloud

---

Introducción

---

La plataforma IDCloud utiliza códigos de respuesta HTTP convencionales para indicar el éxito o el fallo de una solicitud de API.

Como regra geral:

• Códigos en el rango 2xx indican éxito en la solicitud;

• Códigos en el rango 4xx indican parámetros incorrectos o incompletos (por ejemplo, se omitió un parámetro obligatorio o una operación falló con terceros, etc.);

• Códigos en el rango 5xx indican que hubo un error en los servidores de la plataforma Unico IDCloud.

La plataforma Unico IDCloud también genera un mensaje de error y un código de error formateado en JSON:

{
    "error": {
        "code": "0000",
        "description": "error description"
    }
}

Errores posibles

---

En este tema, encontrarás los posibles errores de los endpoints, separados por su respuesta HTTP.

Crear Proceso

400 Bad Request

Code	Mensaje	Descripción
3	invalid flow	Cuando el flujo especificado no existe.
3	invalid purpose	Cuando la propuesta informada no es válida.
3	invalid callbackUri: unable to parse callbackUri: parse "": empty url, invalid callbackUri: url:	Cuando el callbackUri informado no es válido.
3	invalid person: email required for notification channel NOTIFICATION_CHANNEL_EMAIL, invalid email address for notification channel NOTIFICATION_CHANNEL_EMAIL	Cuando el correo electrónico informado no es válido, pero se requiere la notificación por correo.
3	invalid person: phone number required for notification channel NOTIFICATION_CHANNEL_WHATSAPP, phone number does not contain 13 chars for notification channel NOTIFICATION_CHANNEL_WHATSAPP	Cuando el número de teléfono informado no es válido, pero se requiere la notificación por SMS o WhatsApp.
3	idnsv2/GetPublicID request error: rpc error: code = InvalidArgument desc = invalid dui value	Cuando el CPF informado no es válido.
9	XX ID Apikeys are not set	Cuando alguna API Key no fue configurada correctamente.

401 Unauthorized

Mensaje	Descripción
Jwt header is an invalid JSON	Cuando el access-token utilizado contiene caracteres incorrectos.
Jwt is expired	Cuando el access-token utilizado ha expirado.

429 Too Many Requests

500 Internal Server Error

Code	Mensaje	Descripción
99999	Internal failure! Try again later	Cuando hay algún error interno.

Consultar Resultado del Proceso

---

400 Bad Request

Code	Mensaje	Descripción
3	process id is invalid	Cuando el ID del proceso es inválido.

401 Unauthorized

Mensaje	Descripción
Jwt header is an invalid JSON	Cuando el access-token utilizado contiene caracteres incorrectos.
Jwt is expired	Cuando el access-token utilizado ha expirado.

404 Not Found

Code	Mensaje	Descripción
5	error getting process: rpc error: code = NotFound desc = process not found	Cuando el ID del proceso no fue encontrado.

429 Too Many Requests

500 Internal Server Error

Code	Mensaje	Descripción
99999	Internal failure! Try again later	Cuando hay algún error interno.

Obtener Selfie del Usuario

---

400 Bad Request

Code	Mensaje	Descripción
3	process id is invalid	Cuando el ID del proceso es inválido.

401 Unauthorized

Mensaje	Descripción
Jwt header is an invalid JSON	Cuando el access-token utilizado contiene caracteres incorrectos.
Jwt is expired	Cuando el access-token utilizado ha expirado.

403 Forbidden

Code	Mensaje	Descripción
7	no permission	Cuando la cuenta de servicio no tiene permiso para obtener la selfie.

404 Not Found

Code	Mensaje	Descripción
5	error getting process: rpc error: code = NotFound desc = process not found	Cuando el ID del proceso no fue encontrado.

429 Too Many Requests

500 Internal Server Error

Code	Mensaje	Descripción
99999	Internal failure! Try again later	Cuando hay algún error interno.

Obtener Conjunto Probatório

---

400 Bad Request

Code	Mensaje	Descripción
3	process id is invalid	Cuando el ID del proceso es inválido.

401 Unauthorized

Mensaje	Descripción
Jwt header is an invalid JSON	Cuando el access-token utilizado contiene caracteres incorrectos.
Jwt is expired	Cuando el access-token utilizado ha expirado.

403 Forbidden

Code	Mensaje	Descripción
7	no permission	Cuando la cuenta de servicio no tiene permiso para obtener la selfie.

429 Too Many Requests

500 Internal Server Error

Code	Mensaje	Descripción
99999	Internal failure! Try again later	Cuando hay algún error interno.

---

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.