Stempel reduzieren API

Die API zum Reduzieren von Stempeln verringert die Anzahl eines bestehenden Eintrags um eins.

Sie gehört nicht zum normalen Ablauf, sondern wird für Korrekturen wie fehlerhafte Vergaben, Anpassungen von Kampagnenregeln oder zur Bearbeitung von Nutzeranfragen verwendet.
Die Anzahl der Stempel fällt niemals unter null.

Diese API ist ab dem Personal-Tarif verfügbar.

PUT

/api/stamp/v1/remove 

{
    "stampIdx": 394
}

Request Parameters

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

Response Parameters

code integer
Antwortcode: 0 = Erfolg, andere Werte = Fehler
message string
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
result null

Wann Stempel reduziert werden sollten

Diese API ist nicht für die häufige Nutzung gedacht, sondern als Werkzeug zur Behebung von Datenproblemen.
Sie wird in folgenden Fällen eingesetzt:

  • Doppelte Verarbeitung führt zu mehrfacher Stempelvergabe
  • Systemfehler verursachen falsche Erhöhungen
  • Änderungen der Kampagnenregeln erfordern Datenanpassungen
  • Fehlerhafte Vergaben müssen rückgängig gemacht werden

Unkorrigierte Daten erhöhen Kosten und senken das Vertrauen.
Diese API ermöglicht eine sofortige Korrektur.

Beziehung zur Add Stamp API

Beide APIs arbeiten in entgegengesetzte Richtungen, erfüllen jedoch klar definierte Rollen.

  1. Add Stamp → Erfasst Nutzeraktionen im normalen Ablauf
  2. Remove Stamp → Korrigiert oder setzt Daten zurück

Bei jeder Nutzung der Add Stamp API sollten Fehler- und Abbruchszenarien berücksichtigt werden,
und Remove Stamp in den Ablauf integriert werden, um Stabilität zu gewährleisten.

Wichtige Punkte im Betrieb

Die Stempel-Reduzierungs-API wird selten verwendet und ist eine wichtige Verwaltungs-API zur Behebung von Datenproblemen.

  • Nicht korrigierte Daten verringern das Vertrauen
  • Übermäßige Vergabe erhöht die Kosten
  • Kann die Nutzererfahrung negativ beeinflussen

Verwenden Sie sie zusammen mit Audit-Logs und strenger administrativer Zugriffskontrolle.

Wichtige Hinweise

  • Die Anzahl fällt nicht unter 0. Prüfen Sie stamps mit der Validierungs-API vor der Reduzierung
  • Wiederholte Aufrufe können zu übermäßiger Reduzierung führen
  • Nicht direkt vom Client aufrufen; serverseitige Kontrolle ist erforderlich
  • Änderungen protokollieren und durch Adminrechte schützen