API de réduction de tampons

L’API de réduction de tampons diminue de un le nombre de tampons d’un enregistrement existant.

Elle n’est pas utilisée dans le flux normal, mais pour des corrections telles que les erreurs d’accumulation, les modifications de règles de campagne ou la gestion des réclamations.
Le nombre de tampons ne descend jamais en dessous de zéro.

Cette API est disponible à partir de l’offre Personal.

PUT

/api/stamp/v1/remove 

{
    "stampIdx": 394
}

Request Parameters

stampIdx integer required
Stamp IDX. 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer
Code de réponse : 0 = Succès, autres valeurs = Erreur
message string
Message de réponse. Si le code n’est pas 0, un message d’erreur est renvoyé.
result null

Quand utiliser la déduction de tampons

Cette API n’est pas destinée à un usage fréquent, mais sert d’outil pour corriger des problèmes de données.
Elle est utilisée dans les cas suivants :

  • Traitement en double entraînant une accumulation incorrecte
  • Erreurs système provoquant une augmentation incorrecte des tampons
  • Modification des règles nécessitant un ajustement des données
  • Annulation d’accumulations incorrectes

Laisser ces erreurs augmente les coûts et réduit la confiance.
Cette API permet une correction immédiate.

Relation avec l’API Add Stamp

Les deux APIs fonctionnent en sens opposé, avec des rôles clairement définis.

  1. Add Stamp → Enregistre les actions utilisateur dans le flux normal
  2. Remove Stamp → Corrige ou annule les données en cas exceptionnel

Chaque utilisation de Add Stamp API doit inclure des scénarios d’échec et d’annulation,
et intégrer Remove Stamp pour garantir la stabilité du système.

Points clés en opération

L’API de réduction des tampons n’est pas utilisée fréquemment, mais constitue une API essentielle pour résoudre les problèmes de données.

  • Des données incorrectes non corrigées réduisent la confiance
  • L’accumulation excessive augmente les coûts de récompense
  • Peut dégrader l’expérience utilisateur

Utilisez-la avec journalisation d’audit et contrôle d’accès administrateur strict.

Points à considérer

  • Le nombre de tampons ne descend pas sous 0. Vérifiez stamps via l’API de validation avant réduction
  • Des appels répétés peuvent entraîner une réduction excessive
  • Évitez les appels directs côté client; contrôlez via le serveur
  • Enregistrez l’historique et protégez-le avec des droits administrateur