Coupons

Mettre à jour le coupon

Mises à jour de validité, de réduction et d'éligibilité.

PATCH/coupons/{id}coupons:write

COMPORTEMENT

Le changement est validé et conservé dans le compte clé avant de répondre. Interrogez la ressource renvoyée comme source de vérité.

EFFET

Il peut modifier la ressource et émettre l'événement de domaine correspondant.

RÉPÉTITION

En cas de panne du réseau, confirmez l'état de la ressource avant de réessayer. Refaites automatiquement uniquement 429 et 5xx avec recul et gigue.

Demande

idstring · pathIdentificateur de ressource.minLength 2 · maxLength 100obligatoire

marketplacestring · bodyMarché.facultatif

codestring · bodyCode promo.facultatif

descriptionstring · bodyDescription.facultatif

valuestring · bodyValeur présentée.facultatif

minimumnumber · bodyCommande minimale.facultatif

valid_untilstring · bodyValidité ISO.facultatif

typestring · bodyType de coupon.facultatif

discountnumber · bodyPourcentage ou montant de la remise.facultatif

capnumber · bodyPlafond de remise.facultatif

categoriesarray · bodyCatégories éligibles.facultatif

verifiedboolean · bodyMarquez le coupon comme vérifié.facultatif

activeboolean · bodyActivez ou archivez le coupon.facultatif

AuthorizationBearer ach_live_...

Acceptapplication/json

Portéecoupons:write

Exemple d'exécutable

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"
}'

Réponse et erreurs

Chaque réponse inclut request_id. Les listes ajoutent une pagination ; les ressources mutables renvoient l'état persistant après l'opération.

200 application/json

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

200Opération terminée.

400Paramètre, corps ou transition non valide.

401Clé manquante, invalide, expirée ou révoquée.

402Le plan de compte ne libère pas cette interface.

403A chave precisa do escopo coupons:write.

404La fonctionnalité n'existe pas dans ce compte.

409L'état actuel empêche cette opération.

413Le corps JSON dépasse 128 Ko.

429La fenêtre de 120 requêtes par minute a été dépassée.

Mettre à jour le coupon

Demande

Exemple d'exécutable

Réponse et erreurs

Opérations associées