API Kurangi Stempel (v1)

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.

Dokumentasi v1 (Legacy).

Untuk integrasi baru, kami menyarankan penggunaan versi terbaru, v2.
v1 ditujukan untuk mempertahankan integrasi yang sudah ada dan tidak mendapatkan fitur baru atau peningkatan.

API Version

PUT

/api/stamp/v1/remove

Request
Response

{
    "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

Validasi parameter numerik

Jika parameter numerik menerima nilai bukan angka, atau angka di luar rentang yang dapat diproses server, permintaan langsung ditolak dengan 400 (kode kesalahan 653).

Dalam kasus itu data stempel dan riwayat perolehan sama sekali tidak berubah, dan tidak ada catatan event maupun pengiriman Webhook. Jika Anda menerima respons gagal, tidak ada yang tersimpan.

Perubahan perilaku. Sebelumnya v1 tetap melanjutkan permintaan meskipun validasi ini gagal. Akibatnya pesan kesalahan dapat tertimpa oleh pesan parameter lain, atau sebagian data stempel benar-benar tersimpan padahal respons berupa kesalahan. Sekarang permintaan dihentikan dengan 400 sebelum diproses, sama seperti versi terbaru.

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.

Add Stamp → Mencatat aksi pengguna dalam alur normal
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