Activa, desactiva o programa un regalo

Scope requerido: promociones:write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Activa, desactiva o programa un regalo

Scope requeridopromociones:write
MétodoPOST /ext/v3/promociones/{regaloId}/status

Path

ParámetroTipoRequeridoDescripción
regaloIdintegersíId del regalo o promocion (mp_regalos.regalo_id)

Body

ParámetroTipoRequeridoDescripción
comandostringsíComando del modal del dashboard (activar, desactivar, programar, ...)
fechastringnoFecha para comandos programados

Ejemplo

curl -X POST 'https://api3.clau.io/ext/v3/promociones/45/status' \
  -H 'apikey: ck_1_...' \
  -H 'Content-Type: application/json' \
  -d '{"comando":"activar"}'

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.

Path Params
integer
required
≥ 1

Id del regalo o promocion (mp_regalos.regalo_id)

Query Params
boolean

Con true devuelve la ayuda del endpoint en texto plano.

Body Params
string
required
length ≤ 40

Comando del modal del dashboard (activar, desactivar, programar, ...)

string
length ≤ 30

Fecha para comandos programados

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json