Platform Pembangun

Bina dengan s.id — REST API, Webhooks & OAuth

Cipta pautan pendek, jejak klik, dan automatikan aliran kerja anda dengan platform pembangun s.id. Pengesahan kunci API yang mudah, webhook masa nyata, dan OAuth 2.0 untuk aplikasi pihak ketiga.

Dapatkan kunci API anda Lihat Rujukan API

REST API

Urus pautan, kod QR, dan data pengguna dengan API JSON yang bersih. Pengesahan token Bearer, 38 req/min.

Ketahui Lebih Lanjut

Webhooks

Langgan link.created, link.clicked, qr.scanned, dan lagi. Muatan bertanda tangan HMAC.

Ketahui Lebih Lanjut

OAuth 2.0

Aliran kod kebenaran dengan PKCE dan putaran refresh token membolehkan aplikasi anda bertindak bagi pihak pengguna s.id.

Ketahui Lebih Lanjut

Permulaan Pantas

Cipta pautan pendek dalam satu panggilan API.

Buka Dashboard → Pembangun → Kunci API

Cipta kunci dengan skop yang anda perlukan

Panggil API dengan Bearer sk_live_...

URL Asas: https://api.s.id/v2

curl -X POST https://api.s.id/v2/links \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"long_url": "https://example.com/long-url", "custom_slug": "mylink"}'

Titik Akhir

Semua titik akhir memerlukan kunci API dengan skop yang sesuai.

Kaedah	Laluan	Penerangan	Skop
GET	/links	List links	`links:read`
POST	/links	Create a link	`links:write`
POST	/links/available	Check slug availability	`links:read`
GET	/links/{short}	Get a link	`links:read`
PUT	/links/{short}	Update a link	`links:write`
DELETE	/links/{short}	Archive a link	`links:archive`
POST	/links/{short}/unarchive	Restore an archived link	`links:write`
GET	/links/{short}/stats	Link click timeline	`links:analytics`
GET	/links/{short}/stats/lifetime	Lifetime click count	`links:analytics`
GET	/user	Get authenticated user	`user:read`
GET	/quota	Get account quota	`user:read`
GET	/microsites	List microsites	`microsites:read`
POST	/microsites	Create a microsite	`microsites:write`
GET	/microsites/{slug}	Get a microsite	`microsites:read`
PUT	/microsites/{slug}	Update a microsite	`microsites:write`
DELETE	/microsites/{slug}	Delete a microsite	`microsites:write`
POST	/links/bulk	Bulk create links	`links:write`
GET	/stats	Account-level click analytics	`links:analytics`
GET	/qr	Get global QR settings	`qr:read`
PUT	/qr	Customize global QR settings	`qr:write`
GET	/links/{short}/qr	Get a link's QR settings	`qr:read`
PUT	/links/{short}/qr	Customize a link's QR settings	`qr:write`
POST	/microsites/available	Check microsite slug availability	`microsites:read`
GET	/microsites/{slug}/components	List microsite components	`microsites:read`
POST	/microsites/{slug}/components	Add a microsite component	`microsites:write`
PUT	/microsites/{slug}/components/{componentId}	Update a microsite component	`microsites:write`
DELETE	/microsites/{slug}/components/{componentId}	Delete a microsite component	`microsites:write`
POST	/microsites/{slug}/components/order	Reorder microsite components	`microsites:write`
GET	/oauth/authorize	Get consent screen data
POST	/oauth/token	Exchange code or refresh token
POST	/oauth/revoke	Revoke a token
GET	/oauth/userinfo	Get authorized user profile
GET	/api/user/oauth/apps	List apps authorized by the current user
DELETE	/api/user/oauth/apps/{clientId}	Revoke all tokens for an app

Rujukan API Penuh ↗

Skop API

Setiap kunci API mempunyai skop — minta hanya kebenaran yang diperlukan integrasi anda.

links:readList and read links

links:writeCreate and update links (create, edit, restore)

links:archiveArchive links

links:analyticsRead per-link click statistics and lifetime counts

qr:readRead QR code settings (global and per-link)

qr:writeCustomize QR code settings (global and per-link)

user:readRead the authenticated user profile and account quota

microsites:readRead microsites

microsites:writeCreate, update, delete and manage components of microsites

Webhooks

Daftarkan titik akhir HTTPS untuk menerima acara masa nyata. Setiap penghantaran ditandatangani POST dengan HMAC-SHA256.

Acara 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

Contoh muatan

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

Sahkan tandatangan (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),
  );
}

Rahsia dipaparkan sekali semasa anda mencipta webhook. Sahkan sebelum memproses acara.

Panduan penuh webhooks

Pengesahan

Dua cara pengesahan: kunci API untuk pelayan-ke-pelayan, OAuth 2.0 untuk aliran bagi pihak pengguna.

Kunci API

Cipta kunci di Dashboard → Pembangun → Kunci API. Hantarkan sebagai token Bearer. Kunci mempunyai skop dan boleh dibatalkan pada bila-bila masa.

Authorization: Bearer sk_live_...

OAuth 2.0

Gunakan aliran kod kebenaran untuk bertindak bagi pihak pengguna s.id. Alihkan ke /oauth/authorize, tukar kod di /oauth/token.

Panduan OAuth 2.0

Bersedia untuk mula membina?

Cipta kunci API dalam beberapa minit. Peringkat percuma disertakan — tiada kad kredit diperlukan.

Dapatkan kunci API anda