Arreglo de arreglos: el nivel externo es OR entre grupos, el intermedio es AND entre condiciones, y cada condicion es { tipo_filtro, tipo_operador, valor1, valor2?, valor3? }. tipo_operador: 1 igual, 2 mayor, 3 mayor o igual, 4 menor, 5 menor o igual, 6 diferente, 7 contiene (LIKE), 8 no contiene. tipo_filtro del perfil: 1 etiqueta, 2 puntos, 3 nombre, 4 apellido, 5 num. identificacion, 6 telefono, 7 email, 8 fecha de registro, 9 genero, 10 ciudad, 11 codigo de referido usado, 12 mes de cumpleanos, 14 codigo propio, 15 fecha de cumpleanos, 16 uid, 17 id externo, 18 estado, 19 nivel, 20 tipo de id, 21 puntos acumulados, 22-26 texto generico 1-5, 27-29 y 100-101 entero generico 1-5, 102-103 fecha generica 1-2, 104 JSON generico. tipo_filtro de comportamiento: 30 ingreso al app en un periodo; 301 sku comprado, 302 nombre de producto, 303 valor de producto, 304 departamento, 305 talla, 306 color, 307 cantidad de compras en un periodo, 308 tienda en un periodo; 501 sku de membresia; 601 regalo asignado, 602 usado, 603 bloqueado, 604 removido, 605 vencido, 610 punch card con N perforaciones; 701 ingreso a su cuenta en un periodo, 702 sin ingreso en un periodo, 703 nunca ingreso. Los periodos usan valor2/valor3 como fechas YYYY-MM-DD. Devuelve los clientes y el grupoId creado, que se usa en /grupos/{grupoId}/... para acciones masivas.
Scope requerido: segmentos:read
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Arreglo de arreglos: el nivel externo es OR entre grupos, el intermedio es AND entre condiciones, y cada condicion es { tipo_filtro, tipo_operador, valor1, valor2?, valor3? }. tipo_operador: 1 igual, 2 mayor, 3 mayor o igual, 4 menor, 5 menor o igual, 6 diferente, 7 contiene (LIKE), 8 no contiene. tipo_filtro del perfil: 1 etiqueta, 2 puntos, 3 nombre, 4 apellido, 5 num. identificacion, 6 telefono, 7 email, 8 fecha de registro, 9 genero, 10 ciudad, 11 codigo de referido usado, 12 mes de cumpleanos, 14 codigo propio, 15 fecha de cumpleanos, 16 uid, 17 id externo, 18 estado, 19 nivel, 20 tipo de id, 21 puntos acumulados, 22-26 texto generico 1-5, 27-29 y 100-101 entero generico 1-5, 102-103 fecha generica 1-2, 104 JSON generico. tipo_filtro de comportamiento: 30 ingreso al app en un periodo; 301 sku comprado, 302 nombre de producto, 303 valor de producto, 304 departamento, 305 talla, 306 color, 307 cantidad de compras en un periodo, 308 tienda en un periodo; 501 sku de membresia; 601 regalo asignado, 602 usado, 603 bloqueado, 604 removido, 605 vencido, 610 punch card con N perforaciones; 701 ingreso a su cuenta en un periodo, 702 sin ingreso en un periodo, 703 nunca ingreso. Los periodos usan valor2/valor3 como fechas YYYY-MM-DD. Devuelve los clientes y el grupoId creado, que se usa en /grupos/{grupoId}/... para acciones masivas.
| Scope requerido | segmentos:read |
| Método | POST /ext/v3/segmentos/evaluar |
Body
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
filtro | any | sí | Filtro: [[[condicion, condicion]], [[condicion]]] |
Ejemplo
curl -X POST 'https://api3.clau.io/ext/v3/segmentos/evaluar' \
-H 'apikey: ck_1_...' \
-H 'Content-Type: application/json' \
-d '{"filtro":[[[{"tipo_filtro":19,"tipo_operador":3,"valor1":"3"},{"tipo_filtro":1,"tipo_operador":1,"valor1":"VIP"}]]]}'Respuesta 200
{
"codigoRespuesta": 0,
"msj": "Exito",
"data": {
"grupoId": 812,
"total": 2,
"usuarios": [
{
"userId": "uid-7",
"nombre": "Ana",
"apellido": "Perez",
"email": "[email protected]",
"puntos": 125.5
}
]
},
"meta": {
"requestId": "5f1c…",
"appId": 1,
"scope": "segmentos:read"
}
}Errores: 401 key inválida (9501), 403 sin scope (9503, meta.requiredScope), 400 parámetros (details), 409 idempotencia, 422 regla de negocio (meta.legacy), 429 límite de tasa. Agregue ?help=true para la ayuda en texto plano.