s.id Logo
Platform Developer

Webhook

Pengiriman event real-time ke endpoint HTTPS Anda.

Gambaran Umum

Daftarkan endpoint HTTPS publik di Dashboard → Developer → Webhooks. s.id akan POST payload JSON bertanda tangan ke URL Anda ketika event yang dilanggan terjadi. Pengiriman yang gagal (non-2xx atau timeout) akan dicoba ulang hingga 3 kali, dengan jeda 0 detik, 5 detik, dan 30 detik.

Event yang Tersedia

link.createdFired when a new link is created
link.updatedFired when a link's URL or title is changed
link.archivedFired when a link is archived
link.clickedFired on each redirect (per-click event)
microsite.publishedFired when a microsite is published
qr.scannedFired when a QR code is scanned

Struktur Payload

Setiap POST webhook berisi body JSON dengan nama event, resource yang relevan, dan timestamp UTC.

{
  "event": "link.created",
  "link": {
    "id": 123,
    "short": "mylink",
    "short_url": "https://s.id/mylink",
    "long_url": "https://example.com/long-url",
    "title": "My Link",
    "created": "2026-06-22T10:00:00Z"
  },
  "timestamp": "2026-06-22T10:00:00Z"
}

Memverifikasi Tanda Tangan

Setiap pengiriman menyertakan header X-SID-Signature: sha256=<hex>. Hitung HMAC-SHA256 dari body permintaan mentah menggunakan secret webhook Anda dan bandingkan dengan kesetaraan timing-safe.

Selalu verifikasi tanda tangan sebelum memproses event. Jangan pernah mempercayai payload tanpa memverifikasi HMAC.

Node.js

const crypto = require('crypto');

function verifySignature(secret, rawBody, sigHeader) {
  const expected = 'sha256=' +
    crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(sigHeader),
    Buffer.from(expected),
  );
}

Go

func verifySignature(secret, body []byte, sig string) bool {
  mac := hmac.New(sha256.New, secret)
  mac.Write(body)
  expected := "sha256=" + hex.EncodeToString(mac.Sum(nil))
  return hmac.Equal([]byte(sig), []byte(expected))
}

Pengaturan

1Buka Dashboard → Developer → Webhooks dan klik Tambah Webhook.
2Masukkan URL endpoint HTTPS Anda dan pilih event yang ingin Anda langgani.
3Salin secret webhook — ditampilkan hanya sekali.
4Di server Anda, verifikasi header X-SID-Signature sebelum memproses.
5Kembalikan HTTP 2xx dalam 10 detik. Pengiriman yang gagal dicoba ulang hingga 3 kali; setelah 5 kegagalan pengiriman berturut-turut, webhook akan dinonaktifkan secara otomatis.
Platform Developer