API Update Link Group

Kelola dan perbarui banyak short link sekaligus melalui grup.

Ubah pengaturan di tingkat grup untuk mengontrol campaign dengan lebih efisien, serta perbarui pengaturan bersama seperti masa berlaku, password, dan webhook secara bersamaan.

Setiap perubahan pada grup akan diterapkan ke semua link di dalamnya.
Jika terjadi konflik antara pengaturan link dan grup, pengaturan grup akan diprioritaskan.

PUT

/api/link-group/v1/update 

{
    "grpIdx": 5066,
    "nm": "Instagram Group",
    "memo": "A group of links used in Instagram ads.",
    "strtYmdt": "2026-03-01 00:00:00",
    "endYmdt": "2026-03-31 23:59:59",
    "expireUrl": "https://example.com/event-expired"
}

Request Parameters

grpIdx integer required
IDX grup.
Tentukan nilai IDX grup yang ingin diperbarui.
nm string
Nama grup.
Menentukan nama grup yang digunakan untuk mengelompokkan dan mengelola tautan.
memo string
Catatan untuk pengelolaan grup.
Anda dapat mencatat tujuan grup atau informasi pengelolaan lainnya secara bebas.
notfSubscYn string
Default:N
Enum:
YN
Menentukan apakah tautan dibuat sebagai tautan langganan notifikasi push.
Y: Membuat tautan khusus untuk langganan notifikasi push.
N: Membuat tautan biasa.
Ketika pengguna membuka tautan langganan, permintaan berlangganan notifikasi push dari browser akan ditampilkan.
qrBypassYn string
Default:N
Enum:
YN
Menentukan perilaku pengalihan saat tautan diakses melalui kode QR.
Y: Langsung dialihkan ke URL asli. (Statistik klik tidak dicatat)
N: Dialihkan melalui URL tautan pendek. (Statistik klik dicatat)
blockOverseasSticsYn string
Default:N
Enum:
YN
Menentukan apakah akses dari luar negeri dikecualikan dari statistik.
Y: Akses dari luar negeri tidak dimasukkan dalam statistik.
N: Akses dari semua negara dimasukkan dalam statistik.
pushNotifyYn string
Default:N
Enum:
YN
Menentukan apakah notifikasi push dikirim berdasarkan jumlah klik.
Y: Notifikasi push akan dikirim ketika batas yang ditentukan tercapai.
N: Notifikasi push tidak dikirim.
Fitur ini tersedia mulai dari paket Personal.
mailNotifyYn string
Default:N
Enum:
YN
Menentukan apakah notifikasi email dikirim berdasarkan jumlah klik.
Y: Email akan dikirim ketika batas yang ditentukan tercapai.
N: Email tidak dikirim.
Fitur ini tersedia mulai dari paket Personal.
nonmemberSticsPwd string
Kata sandi untuk melihat statistik klik bagi pengguna non-anggota.
Jika Anda ingin mengizinkan pengguna non-anggota melihat statistik klik, tetapkan kata sandi yang harus dimasukkan saat mengakses halaman statistik.
strtYmdt datetime
Tanggal dan waktu mulai masa berlaku tautan.
Tautan dapat diakses setelah tanggal dan waktu yang ditentukan.
Contoh: 2026-03-01 00:00:00
endYmdt datetime
Tanggal dan waktu berakhirnya masa berlaku tautan.
Setelah waktu yang ditentukan, akses ke tautan akan diblokir.
Contoh: 2026-03-31 23:59:59
expireUrl string
URL tujuan setelah tautan kedaluwarsa.
Jika tidak ditentukan, halaman pemberitahuan default akan ditampilkan.
Contoh: https://example.com/event-expired
pwd string
Kata sandi untuk mengakses tautan.
Jika ditetapkan, pengguna harus memasukkan kata sandi sebelum dapat membuka halaman tujuan.
acesMaxCnt integer
Jumlah maksimum klik yang diizinkan.
Jika batas yang ditentukan terlampaui, akses ke tautan akan diblokir. (0 berarti tanpa batas)
webhookEnableYn string
Default:N
Enum:
YN
Menentukan apakah fitur Webhook digunakan.
Webhook global harus diaktifkan terlebih dahulu.
Fitur ini hanya tersedia pada paket Enterprise.
webhookCallbackUrl string
URL server yang menerima event Webhook.
Wajib diisi ketika webhookEnableYn bernilai Y. Masukkan endpoint pada server Anda yang menerima data event.
Contoh: https://api.example.com/webhook
webhookMetric string
Default:C
Enum:
CP
Kriteria pemicu Webhook.
C: berdasarkan jumlah klik, P: berdasarkan jumlah pengguna (klik unik)
webhookFrequency integer
Default:1
Enum:
1501002003005001000
Frekuensi pengiriman Webhook.
1: setiap klik, 50: setiap 50 klik, 100: setiap 100 klik, 300: setiap 300 klik, 500: setiap 500 klik, 1000: setiap 1.000 klik 
{
    "code": 0,
    "message": "",
    "result": null  // When the ‘webhookEnableYn’ parameter is set to ‘Y’, a secret key is specified.
}

Response Parameters

code integer
Kode respons: 0 = Berhasil, nilai lainnya = Error
message string
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
result string
Jika webhookEnableYn bernilai Y, secret key akan dibuat dan dikirimkan.
Jika webhookSecretKey sudah ada pada grup, kunci baru tidak akan dibuat atau dikirimkan.

Kapan menggunakan API ini

Gunakan API ini saat mengelola short link satu per satu sudah tidak efisien.

  • Menonaktifkan banyak link campaign sekaligus atau mengubah periode aktifnya
  • Membatasi akses semua link setelah event tertentu berakhir
  • Menerapkan pengaturan yang sama ke banyak link dalam satu langkah
Pengelolaan berbasis grup membantu mengurangi beban operasional dibandingkan pengeditan satu per satu.

Fitur utama dan dampak pengaturan

API ini tidak hanya melakukan update, tetapi mengatur bagaimana sistem link Anda berjalan.

Kontrol akses

  • Membatasi akses untuk pengguna non-member
  • Membatasi akses QR code → hanya untuk pengguna tertentu

Analitik dan filtering

  • Mengecualikan traffic bot → meningkatkan akurasi data

Notifikasi

  • Push dan email → respons real-time terhadap event link

Pengaturan waktu

  • Atur tanggal mulai dan berakhir → aktif/nonaktif otomatis

Penanganan kedaluwarsa

  • Redirect setelah expired → menjaga pengalaman pengguna

Webhook

  • Kirim data ke server eksternal → integrasi dan otomatisasi

Contoh penggunaan

  • Campaign marketing: Nonaktifkan semua link saat campaign berakhir dan arahkan otomatis ke URL expired
  • Layanan SaaS: Kelompokkan link berdasarkan fitur dan kelola akses serta masa aktif secara terpusat
  • Pengelolaan skala besar: Gunakan webhook untuk sinkronisasi event klik dengan sistem internal secara real-time
  • Keamanan: Jaga keamanan dengan mengganti password secara berkala

Hal yang perlu diperhatikan

  • Perubahan pengaturan grup langsung berlaku untuk semua link
  • Kesalahan pengaturan tanggal dapat membatasi akses ke semua link
  • Pengiriman webhook dapat tertunda tergantung ketersediaan server eksternal
  • Perubahan filter analitik dapat memengaruhi interpretasi data yang sudah ada