Cupones

Actualizar cupón

Actualizaciones de validez, descuento y elegibilidad.

PATCH/coupons/{id}coupons:write

COMPORTAMIENTO

El cambio se valida y persiste en la cuenta clave antes de responder. Consulta el recurso devuelto como fuente de verdad.

EFECTO

Puede cambiar el recurso y emitir el evento de dominio correspondiente.

REPETICIÓN

En caso de falla de la red, confirme el estado del recurso antes de volver a intentarlo. Rehaga automáticamente solo 429 y 5xx con retroceso y fluctuación.

Solicitar

idstring · pathIdentificador de recursos.minLength 2 · maxLength 100obligatorio

marketplacestring · bodyMercado.opcional

codestring · bodyCódigo de cupón.opcional

descriptionstring · bodyDescripción.opcional

valuestring · bodyValor presentado.opcional

minimumnumber · bodyPedido mínimo.opcional

valid_untilstring · bodyValidez ISO.opcional

typestring · bodyTipo de cupón.opcional

discountnumber · bodyPorcentaje o importe del descuento.opcional

capnumber · bodyTecho de descuento.opcional

categoriesarray · bodyCategorías elegibles.opcional

verifiedboolean · bodyMarque el cupón como verificado.opcional

activeboolean · bodyActiva o archiva el cupón.opcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Alcancecoupons:write

Ejemplo ejecutable

curl

curl -X PATCH 'https://achadu.com/api/v1/coupons/resource_id' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "marketplace": "string",
  "code": "string",
  "description": "string"
}'

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

200 application/json

{
  "data": {
    "id": "cpn_01J...",
    "marketplace": "amazon",
    "code": "HOME10",
    "discount": 10,
    "verified": 1,
    "active": 1
  },
  "request_id": "req_01J..."
}

200Operación completada.

400Parámetro, cuerpo o transición no válidos.

401Clave faltante, inválida, caducada o revocada.

402El plan de cuenta no libera esta interfaz.

403A chave precisa do escopo coupons:write.

404La característica no existe en esta cuenta.

409El estado actual impide esta operación.

413El cuerpo JSON supera los 128 KB.

429Se ha superado la ventana de 120 solicitudes por minuto.

Actualizar cupón

Solicitar

Ejemplo ejecutable

Respuesta y errores

Operaciones relacionadas