Consultar EUID
Utilice esta API para consultar el EUID de un usuario existente mediante un identificador configurado en el proyecto. La API solo lee datos existentes: no crea usuarios ni genera un EUID nuevo cuando no encuentra coincidencias. Esta API aplica un límite de 1.000 solicitudes por minuto y proyecto; si se supera, se devuelve HTTP 429 con el código de error 55110.
Dirección de invocación
POST /v1/user/euid
Verificación de invocación
La API REST de EngageLab utiliza HTTP Basic Authentication:
Authorization: Basic ${base64_auth_string}
Authorization: Basic ${base64_auth_string}
Este bloque de código se muestra en una ventana flotante
Genere base64_auth_string como base64(api_key:api_secret).
Ejemplo de solicitud
{
"identity_name": "user_id",
"identity_values": ["user-1", "user-2"]
}
{
"identity_name": "user_id",
"identity_values": ["user-1", "user-2"]
}
Este bloque de código se muestra en una ventana flotante
Parámetros de solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| identity_name | String | Sí | Nombre de un identificador configurado en el proyecto. |
| identity_values | Array |
Sí | Valores del identificador; de 1 a 100 valores, cada uno de hasta 256 caracteres. |
Parámetros de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| code | Int | 0 indica éxito, incluso si algún valor no coincide. |
| message | String | Descripción del resultado. |
| data | Array | Resultados en el mismo orden que los valores solicitados. |
| identity_value | String | Valor del identificador solicitado. |
| euid | Long | EUID existente o null si no se encuentra ningún usuario. |
| error_code | Int | 0 para una consulta correcta; un valor sin coincidencia también devuelve 0. |
Ejemplo de respuesta
{
"code": 0,
"message": "success",
"data": [
{"identity_value": "user-1", "euid": 10362473, "error_code": 0},
{"identity_value": "user-not-found", "euid": null, "error_code": 0}
]
}
{
"code": 0,
"message": "success",
"data": [
{"identity_value": "user-1", "euid": 10362473, "error_code": 0},
{"identity_value": "user-not-found", "euid": null, "error_code": 0}
]
}
Este bloque de código se muestra en una ventana flotante
Códigos de error
| Código | Descripción |
|---|---|
| 40050 | Falló la autenticación de la interfaz. |
| 55004 | Los parámetros de negocio no son válidos. |
| 55101 | La cantidad de identificadores supera 100. |
| 55105 | Un valor supera los 256 caracteres. |
| 55106 | El identificador no está configurado en el proyecto. |
| 55107 | El nombre o valor del identificador está vacío. |
| 55110 | Se superó el límite de solicitudes (máximo 1.000 solicitudes por minuto y proyecto). |
