ShieldtagOPEN APISatu API untuk keaslian, loyalitas, dan insight produk Anda.
Hubungkan aplikasi, website, CRM, atau ERP Anda langsung ke ekosistem Shieldtag. Verifikasi produk, kelola garansi dan poin konsumen, pantau distribusi, dan baca perilaku pembeli secara real-time.
Apa itu Shieldtag Open API?
Shieldtag Open API adalah REST API yang tersedia untuk setiap client Shieldtag. Dengan API ini, semua fitur Shieldtag dapat dipakai langsung di sistem milik brand sendiri. Konsumen tetap melihat brand Anda, sementara Shieldtag bekerja di belakang layar untuk menjaga keaslian produk dan mengumpulkan data.
Kenapa Memilih Open API Shieldtag?
- Terintegrasi penuh — fitur cek keaslian, garansi, dan poin tampil di aplikasi atau website Anda sendiri.
- Real-time — webhook langsung mengabari sistem Anda setiap ada scan, distribusi, atau perubahan garansi.
- Aman berlapis — OAuth2 Bearer token, verifikasi secret key, dan enkripsi payload AES-256-GCM.
- Data siap pakai — statistik demografi pembeli, lokasi scan, hingga titik pemalsuan.
- Mudah diimplementasikan — REST API berformat JSON, paginasi dan pencarian bawaan, dokumentasi berbahasa Indonesia.
Fitur yang Anda Dapatkan
1. Verifikasi & Scan Produk (Shieldcode)
Shieldcode adalah QR Code terenkripsi dengan tiga lapis keamanan: ID, Shieldcode, dan PIN 6 digit.
- Cek ID Shieldcode — cek data produk berdasarkan ID.
- Scan Shieldcode — verifikasi keaslian dengan ID, token, dan PIN, lengkap dengan data lokasi dan konsumen.
- Scan Secure QR — verifikasi lewat gambar QR yang dilindungi fitur anti-pemalsuan dan anti-manipulasi.
- Scan SQR Lite — verifikasi tanpa PIN. Gambar QR dicocokkan dengan QR original; hasil fotokopi terdeteksi dan tercatat sebagai scan gagal.
- Riwayat Scan — seluruh riwayat scan produk.
2. Data Konsumen
- Daftar konsumen dengan pencarian nama.
- Detail profil konsumen.
- Riwayat scan per konsumen.
3. Program Loyalitas Poin
- Cek Poin — saldo poin konsumen berdasarkan email atau nomor HP.
- Daftar Hadiah — katalog hadiah aktif, bisa dicari berdasarkan nama.
- Redeem Poin — penukaran poin dengan hadiah, termasuk untuk konsumen yang belum punya akun Shieldtag (via nomor HP).
- Detail Redeem — pantau status penukaran.
4. Master Produk & Sertifikat
- Daftar dan detail produk, dengan pencarian nama produk.
- Daftar sertifikat produk berdasarkan ID Shieldcode.
5. Garansi Digital
- Detail Garansi — data garansi beserta klaim dan konsumennya.
- Aktivasi Garansi — aktivasi dengan unggah invoice; akun konsumen otomatis dibuat bila belum terdaftar.
- Klaim Garansi — ajukan klaim untuk garansi yang aktif, lalu pantau pengerjaannya.
Mendukung garansi otomatis maupun manual, dengan status lengkap: Tidak Aktif, Aktif, Klaim, Kadaluarsa, dan Ditolak.
6. Distribusi & Rantai Pasok
- Pemasukan Shieldcode — total Shieldcode hasil generate.
- Pengeluaran Shieldcode — total Shieldcode yang dikirim ke tiap distributor.
- Daftar Distributor — data seluruh distributor, dengan pencarian nama.
7. Statistik & Business Insight
Semua data statistik dapat difilter berdasarkan rentang tanggal.
Statistik & Business Insight Kelompok Data yang tersedia Profil pembeli Asal kota, minat pembelian, jenis kelamin, usia, sistem operasi Performa scan Tren scan harian/mingguan/bulanan/tahunan, lokasi scan tertinggi (kota, provinsi, negara), segmentasi App vs Mobile Shieldcode & distribusi Jumlah dan sisa Shieldcode, rata-rata distribusi, distribusi per distributor, produk dengan distribusi tertinggi Anti-pemalsuan Jumlah scan produk palsu per produk, lokasi pemalsuan tertinggi 8. Forum
- Daftar dan detail forum untuk ditampilkan di kanal milik brand.
Notifikasi Real-time (Webhook)
Webhook mengirim data otomatis ke sistem Anda setiap kali sebuah peristiwa terjadi.
| Kategori | Peristiwa | Contoh pemanfaatan |
|---|---|---|
| Master Produk | Tambah produk, ubah produk | Sinkronisasi katalog di website atau marketplace |
| Scan Shieldcode | Scan berhasil (Shieldcode, Secure QR, SQR Lite) | Data konsumen, produk, dan lokasi masuk otomatis ke CRM |
| Sertifikat Produk | Tambah sertifikat | Perbarui halaman detail produk |
| Garansi Produk | Pengajuan & pembaruan klaim, pengajuan & verifikasi aktivasi, garansi aktif otomatis, garansi kadaluarsa | Sinkronisasi dengan service center |
| Distribusi | Tambah distribusi | Sinkronisasi dengan ERP atau sistem gudang |
Keamanan Berlapis
- OAuth2 Bearer token untuk setiap permintaan API.
- Secret key pada setiap webhook untuk memastikan data benar-benar dari Shieldtag.
- Enkripsi payload AES-256-GCM (opsional, diatur per jenis webhook).
- Contoh kode dekripsi dalam 7 bahasa: PHP, Python, Node.js, Java, Go, C#, dan Ruby, plus data uji.
Mudah Diintegrasikan
- REST API standar dengan format JSON.
- Paginasi bawaan (default 10 data per halaman) dan pencarian kata kunci.
- Dokumentasi berbahasa Indonesia, lengkap dengan contoh request dan response.
Contoh Pemanfaatan
- Aplikasi brand sendiri — fitur cek keaslian, garansi, dan poin dalam satu aplikasi.
- Website & e-commerce — halaman verifikasi produk dan aktivasi garansi.
- CRM & marketing — data konsumen hasil scan langsung jadi database untuk promo.
- ERP & gudang — pantau alur distribusi Shieldcode ke tiap distributor.
- Dashboard internal — tarik statistik pembeli dan peta pemalsuan ke laporan perusahaan.
- Service center — kelola klaim garansi dari sistem sendiri.
Cara Memulai
Bergabung sebagai client Shieldtag.
Ambil API Key di dasbor: menu Integrasi » API.
Kirim permintaan pertama dengan Bearer token.
(Opsional) Daftarkan URL webhook dan ambil Secret Key di menu Integrasi » Webhook.
Siap melindungi produk Anda lebih jauh? Hubungi tim Shieldtag untuk mulai integrasi.