API Hapus Stempel

API Hapus Stempel memungkinkan Anda menghapus stempel yang telah diterbitkan secara permanen.

Setelah dihapus, stempel tidak dapat dipulihkan dan seluruh riwayat terkait juga akan dihapus.
Untuk menghapus beberapa stempel sekaligus, gunakan dashboard.

API ini tersedia mulai dari paket Personal ke atas.

DELETE

/api/stamp/v1/delete?stampIdx={stampIdx} 


DELETE /api/stamp/v1/delete
        ?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 sebaiknya menghapus stempel

Menghapus stempel bukan sekadar membersihkan data.
Bagi pengguna, ini berarti kehilangan seluruh stempel yang telah dikumpulkan. Pertimbangkan hal berikut sebelum menggunakan API penghapusan.

Kapan penghapusan tepat dilakukan

  • Stempel yang dibuat untuk keperluan testing
  • Stempel duplikat atau salah terbit yang tidak pernah ditampilkan ke pengguna
  • Stempel yang sudah digunakan dan tidak lagi diperlukan

Kapan menggunakan API update

  • Stempel sudah dimiliki pengguna → Ubah activeYn menjadi N untuk menonaktifkan
  • Hanya ingin mengubah masa berlaku → Update endYmd
  • Ingin menonaktifkan sementara → Nonaktifkan dengan activeYn lalu aktifkan kembali

Gunakan dengan hati-hati di lingkungan produksi.
Penghapusan bersifat permanen, jadi prioritaskan nonaktifkan jika terkait dengan data pengguna.

Poin penting dalam operasional

Data stempel terhubung langsung dengan riwayat aktivitas pengguna, sehingga penghapusan harus dilakukan dengan hati-hati.

  • Penghapusan dapat memengaruhi perhitungan kelayakan reward
  • Hasil dapat berubah dalam kampanye berbasis akumulasi
  • Perlu mempertimbangkan potensi keluhan atau komplain pengguna

Sebaiknya prioritaskan perubahan status atau gunakan API Update dibandingkan penghapusan.

Cara mengetahui stampIdx

stampIdx adalah ID unik yang dikembalikan saat membuat stempel.

Jika tidak disimpan, Anda dapat menemukannya melalui dashboard.

Karena penghapusan tidak dapat dibatalkan, pastikan stampIdx mengarah ke data yang benar sebelum memanggil API.

Contoh penggunaan

  • Menghapus data yang salah: Menghapus stempel duplikat akibat kesalahan sistem
  • Pembersihan data testing: Menghapus stempel dari proses development, staging, atau QA
  • Pembersihan data kampanye: Menghapus stempel yang tidak diperlukan dari kampanye yang sudah selesai atau berakhir