API Kurangi Stempel

API Kurangi Stempel mengurangi jumlah stempel pada data yang ada sebanyak satu.

API ini tidak digunakan dalam alur normal, melainkan untuk koreksi seperti perbaikan akumulasi yang salah, perubahan aturan kampanye, atau penanganan klaim pengguna.
Jumlah stempel tidak akan pernah turun di bawah nol.

API ini tersedia mulai dari paket Personal ke atas.

PUT

/api/stamp/v1/remove 

{
    "stampIdx": 394
}

Request Parameters

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

Response Parameters

code integer
Kode respons: 0 = Berhasil, nilai lainnya = Error
message string
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
result null

Kapan perlu pengurangan stempel

API ini tidak digunakan secara rutin, melainkan sebagai alat untuk menangani masalah data.
Digunakan dalam kondisi berikut:

  • Event diproses dua kali sehingga stempel bertambah ganda
  • Kesalahan sistem menyebabkan penambahan stempel tidak valid
  • Perubahan aturan kampanye memerlukan penyesuaian data
  • Pembatalan akumulasi yang salah

Data yang salah dapat meningkatkan biaya dan menurunkan kepercayaan.
API ini memungkinkan perbaikan secara langsung.

Hubungan dengan Add Stamp API

Kedua API bekerja berlawanan arah, namun memiliki peran yang jelas.

  1. Add Stamp → Mencatat aksi pengguna dalam alur normal
  2. Remove Stamp → Mengoreksi atau melakukan rollback data

Setiap penggunaan Add Stamp API harus mempertimbangkan skenario gagal dan pembatalan,
dan mengintegrasikan Remove Stamp untuk memastikan sistem tetap stabil.

Poin penting dalam operasional

API Pengurangan Stempel tidak digunakan secara rutin, tetapi merupakan API penting untuk menangani masalah data.

  • Data yang tidak diperbaiki dapat menurunkan kepercayaan pengguna
  • Akumulasi berlebih meningkatkan biaya reward
  • Dapat berdampak negatif pada pengalaman pengguna

Gunakan bersama audit log dan kontrol akses admin yang ketat.

Hal yang perlu diperhatikan

  • Jumlah stempel tidak akan kurang dari 0. Periksa stamps melalui API Validasi sebelum pengurangan
  • Pemanggilan berulang dapat menyebabkan pengurangan berlebih
  • Jangan dipanggil langsung dari client; lakukan kontrol di server
  • Simpan riwayat pengurangan dan lindungi dengan kontrol akses admin