patch
https://api3.clau.io/ext/v3/promociones/
Envie los campos completos del regalo (el dashboard envia el formulario entero): rTitulo, rTipo y los demas de POST /promociones, mas rCostoPuntos, rActivoTienda, rEtiquetas y status.
Scope requerido: promociones:write
Escritura: header Idempotency-Key obligatorio.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Envie los campos completos del regalo (el dashboard envia el formulario entero): rTitulo, rTipo y los demas de POST /promociones, mas rCostoPuntos, rActivoTienda, rEtiquetas y status.
| Scope requerido | promociones:write |
| Método | PATCH /ext/v3/promociones/{regaloId} |
| Idempotencia | header Idempotency-Key obligatorio |
Path
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
regaloId | integer | sí | Id del regalo o promocion (mp_regalos.regalo_id) |
Body
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
rTitulo | string | no | Titulo del regalo |
rDescripcion | string | no | |
rTipo | integer | no | Tipo de regalo, mismo catalogo del dashboard. Conocidos: 4 punch card (usa punchVMax y las imagenes punch*), 101 codigo promocional unico (codigoPromocion), 103 codigo promocional multicodigo, 200 canje con codigo externo (mensaje = codigo), 7 juego (se crea por POST /juegos). Los demas tipos numericos son regalos/cupones simples segun el dashboard. |
rValor | string | no | Valor del regalo (monto, porcentaje o producto segun el tipo) |
rImagen | string | no | URL de la imagen |
rExpiracionDias | integer | no | Vence N dias despues de asignado |
rExpiracionFecha | string | no | Fecha fija de vencimiento YYYY-MM-DD |
rExpiracionDiaMes | string | no | Vence un dia del mes |
codigoPromocion | string | no | Codigo promocional |
mensaje | string | no | Mensaje push al asignar |
punchVMax | integer | no | Punch card: perforaciones para completar |
punchImgBg | string | no | |
punchImgLleno | string | no | |
punchImgVacia | string | no | |
rCostoPuntos | number | no | Costo en puntos en la tienda de puntos |
rActivoTienda | boolean | no | Visible en la tienda de puntos |
rEtiquetas | string | no | Etiquetas separadas por coma |
status | integer | no | Estado del regalo |
Ejemplo
curl -X PATCH 'https://api3.clau.io/ext/v3/promociones/45' \
-H 'apikey: ck_1_...' \
-H 'Idempotency-Key: 6f1e2d3c-0001' \
-H 'Content-Type: application/json' \
-d '{"rTitulo":"Cafe gratis","rTipo":101}'Respuesta 200
{
"codigoRespuesta": 0,
"msj": "Exito",
"data": "…",
"meta": {
"requestId": "5f1c…",
"appId": 1,
"scope": "promociones: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.