Modifier un coupon
patch
https://mudey.fr/api/v1/coupons/{couponId}courses:writeSeuls les champs envoyés changent. Le code ne se modifie pas : il circule déjà chez des acheteurs ; désactivez le coupon et créez-en un autre.
En-tête Authorization: Bearer mudey_sk_… obligatoire. Créer et utiliser une clé
Paramètres
| Nom | Emplacement | Type | Description |
|---|---|---|---|
| couponId* | chemin | string |
Corps JSON
Les champs marqués * sont obligatoires.
| Champ | Type | Description |
|---|---|---|
| courseId | string | null | Formation visée (une des vôtres). null : toutes vos formations. |
| discountType | PERCENTAGE | FIXED | PERCENTAGE : pourcentage du prix. FIXED : montant retiré. |
| discountValue | number | Pourcentage (20 = 20 %, 12.5 accepté, 100 au plus) ou montant dans la devise de la formation. |
| maxUses | integer | null | Nombre d'utilisations au plus ; null = illimité. Jamais sous usedCount. |
| expiresAt | string | null | Échéance ISO 8601 avec fuseau (2026-12-31T23:59:59Z) ; null = sans fin. |
| isActive | boolean | Utilisable au paiement. true par défaut. |
Réponses
200Coupon à jour.401Clé absente, invalide, révoquée ou expirée.403Droit manquant sur la clé, ou compte qui n'est plus formateur.404Ressource introuvable dans vos formations.422Données invalides (details liste les champs).429Quota dépassé (300 appels par minute et par clé). Voir l'en-tête Retry-After.
Exemple
export MUDEY_API_KEY="mudey_sk_..."
export COUPON_ID="..." # à remplacer
curl -X PATCH "https://mudey.fr/api/v1/coupons/$COUPON_ID" \
-H "Authorization: Bearer $MUDEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"isActive": false
}'