Installieren Sie die Vivoldi-App von Google Play, um es noch bequemer zu machen.

Stempel reduzieren API (v1)

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.

v1-Dokumentation (Legacy).

Für neue Integrationen empfehlen wir die Verwendung der neuesten Version v2.
v1 dient der Aufrechterhaltung bestehender Integrationen und erhält keine neuen Funktionen oder Verbesserungen.

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

Prüfung numerischer Parameter

Erhält ein numerischer Parameter einen nicht numerischen Wert oder eine Zahl außerhalb des vom Server verarbeitbaren Bereichs, wird die Anfrage sofort mit 400 (Fehlercode 653) abgelehnt.

In diesem Fall ändern sich Stempeldaten und Sammelhistorie überhaupt nicht, und es entsteht weder ein Ereigniseintrag noch eine Webhook-Zustellung. Eine Fehlerantwort bedeutet, dass nichts gespeichert wurde.

Hinweis zur Verhaltensänderung. Bisher verarbeitete v1 die Anfrage auch dann weiter, wenn diese Prüfung fehlschlug. Dadurch konnte der Fehler von der Meldung eines anderen Parameters überschrieben werden, oder ein Teil der Stempeldaten wurde tatsächlich gespeichert, obwohl die Antwort einen Fehler meldete. Jetzt bricht die Verarbeitung wie in der neuesten Version vorher mit 400 ab.

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