post
https://api3.clau.io/ext/v3/grupos//puntos
Scope requerido: puntos:write
Accion de grupo: envie primero dryRun: true para ver cuantos clientes afecta; limite group_per_min por key y EXT_V3_MAX_GRUPO clientes por accion.
Escritura: header Idempotency-Key obligatorio.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Agrega o quita puntos a todos los clientes de un grupo
| Scope requerido | puntos:write |
| Método | POST /ext/v3/grupos/{grupoId}/puntos |
| Idempotencia | header Idempotency-Key obligatorio |
| Acción de grupo | acepta dryRun: true; límite group_per_min |
Path
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
grupoId | integer | sí | Id del grupo (mp_grupo_user_filtro.grupo_u_f_id) creado con POST /segmentos/evaluar |
Body
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
dryRun | boolean | no | Con true no ejecuta: devuelve cuantos clientes afecta y el costo estimado Default false. |
puntos | number | sí | Puntos a agregar (negativo para quitar), en la unidad publica (la misma que muestra el dashboard). Limite por llamada: 10000 |
motivo | string | no | Motivo (queda en la auditoria) |
Ejemplo
curl -X POST 'https://api3.clau.io/ext/v3/grupos/812/puntos' \
-H 'apikey: ck_1_...' \
-H 'Idempotency-Key: 6f1e2d3c-0001' \
-H 'Content-Type: application/json' \
-d '{"puntos":150,"motivo":"Compensacion ticket 4412"}'Respuesta 200
{
"codigoRespuesta": 0,
"msj": "Exito",
"data": "…",
"meta": {
"requestId": "5f1c…",
"appId": 1,
"scope": "puntos:write"
}
}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.