Lewati ke konten utama
s.id Logo

Platform developer

Bangun di atas s.id.API, webhook, dan MCP.

Bangun alur manajemen link, QR, microsite, dan analitik dengan API key atau OAuth 2.0—serta hubungkan agen AI yang kompatibel melalui server MCP terkelola.

Buat API KeyBaca dokumentasi
Contoh request API dan percakapan agen MCP
  • API key dengan scope
  • Webhook bertanda HMAC
  • 28 tool MCP terkelola

Pilih jalur integrasi yang sesuai dengan produkmu.

Endpoint REST publik menerima API key terbatas atau access token OAuth 2.0.

Batas default adalah 38 permintaan per menit untuk setiap kredensial—per API key atau access token OAuth. Aplikasi OAuth juga memiliki batas gabungan 500 permintaan per menit untuk seluruh tokennya.

Ketersediaan paket

Akses MCP terkelola diaktifkan berdasarkan paket langganan. Periksa ketersediaan dan penggunaan akunmu di Developer Dashboard.

Satu platform, empat jalur.

Gunakan spesifikasi OpenAPI kanonis untuk membuat SDK dan panduan developer untuk konteks implementasi.

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": "[your-alias]"}'

REST API

Kelola link, QR Code, microsite, analitik, dan data akun melalui JSON API yang rapi.

Authorization codeSekali pakai; kedaluwarsa setelah 10 menit
Access tokenBerlaku selama 1 jam
Refresh tokenBerlaku selama 30 hari

OAuth 2.0

Gunakan authorization code, PKCE, refresh token berotasi, discovery, dan revocation.

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

Webhooks

Terima event link, microsite, dan QR secara real-time melalui payload bertanda tangan HMAC.

Klien MCP yang didukung dan daftar tool s.id

mcp.s.id/mcp

Linkscreate_link
Micrositescreate_microsite
QRget_link_qr
Accountget_quota

MCP

Berikan agen AI yang kompatibel akses terbatas ke 28 tool terkelola untuk link, QR, dan microsite.

Percobaan3 (0, 5, 30 dtk)
Nonaktif otomatisSetelah 5 event gagal
Batas request38 per menit

Kebijakan retry dan keamanan

Event gagal mendapat maksimal tiga percobaan dengan jeda 0, 5, dan 30 detik. Setelah lima event gagal berturut-turut, webhook otomatis dinonaktifkan.

Metode mana yang sebaiknya digunakan?

Operasi publik /v2 menerima API key terbatas atau access token OAuth 2.0. Operasi pengelolaan OAuth memiliki persyaratan browser, sesi, atau kredensial klien masing-masing.

  1. 01

    API key

    Cocok untuk backend milikmu, pekerjaan terjadwal, dan automasi privat saat kredensial tidak pernah dikirim ke browser atau aplikasi mobile.

  2. 02

    OAuth 2.0

    Cocok untuk aplikasi pihak ketiga yang membutuhkan persetujuan pengguna dan akses terperinci yang dapat dicabut ke akun s.id.

  3. 03

    MCP

    Server MCP s.id menyediakan tool JSON-RPC melalui satu endpoint. Klien dapat memakai API key atau access token OAuth 2.0 yang sama dengan REST API dan menemukan metadata otorisasi melalui RFC 9728.

Dokumentasi developer

Mulai integrasi pertamamu.

Buat API KeyBaca dokumentasi

Kredensial dibatasi oleh scope. Scope yang kurang menghasilkan 403 insufficient_scope. Minta hanya izin yang dibutuhkan integrasimu.