Langkau ke kandungan utama
s.id Logo

Platform pembangun

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

Bina aliran kerja pengurusan pautan, QR, microsite, dan analitik dengan API key atau OAuth 2.0—dan sambungkan ejen AI yang serasi melalui pelayan MCP yang dihoskan.

Contoh permintaan API dan sesi ejen MCP
  • API key berskop
  • Webhook bertandatangan HMAC
  • 28 alat MCP yang dihoskan

Pilih laluan integrasi yang sesuai dengan produk anda.

Endpoint REST awam menerima API key berskop atau token akses OAuth 2.0.

Had lalai ialah 38 permintaan seminit bagi setiap kelayakan—bagi setiap API key atau token akses OAuth. Apl OAuth juga mempunyai had gabungan 500 permintaan seminit merentas token mereka.

Ketersediaan pelan

Akses MCP yang dihoskan diaktifkan mengikut peringkat langganan. Semak Papan Pemuka Pembangun untuk ketersediaan dan penggunaan akaun anda semasa.

Satu platform, empat cara masuk.

Guna spesifikasi OpenAPI kanonik untuk penjanaan SDK dan panduan pembangun untuk konteks pelaksanaan.

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

Urus pautan, kod QR, microsite, analitik, dan data akaun dengan API JSON yang kemas.

Kod kebenaranSekali guna; tamat selepas 10 minit
Token aksesTamat selepas 1 jam
Token muat semulaTamat selepas 30 hari

OAuth 2.0

Guna kod kebenaran, PKCE, refresh token berputar, penemuan, dan pembatalan.

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

Webhook

Terima peristiwa pautan, microsite, dan QR secara masa nyata melalui muatan bertandatangan HMAC.

Klien MCP yang disokong dan senarai alat s.id

mcp.s.id/mcp

Linkscreate_link
Micrositescreate_microsite
QRget_link_qr
Accountget_quota

MCP

Beri ejen AI yang serasi akses berskop kepada 28 alat yang dihoskan untuk pautan, QR, dan microsite.

Percubaan3 (0, 5, 30 s)
Lumpuh automatikSelepas 5 peristiwa gagal
Had kadar38 permintaan seminit

Dasar cuba semula dan keselamatan

Peristiwa yang gagal menerima sehingga tiga percubaan keseluruhan dengan kelewatan 0, 5, dan 30 saat. Selepas lima peristiwa gagal berturut-turut, webhook dilumpuhkan secara automatik.

Kaedah mana yang patut anda guna?

Operasi /v2 awam menerima sama ada API key berskop atau token akses OAuth 2.0. Operasi pengurusan OAuth menggunakan keperluan pelayar, sesi, atau kelayakan klien sendiri.

  1. 01

    Kunci API

    Sesuai untuk backend anda sendiri, tugasan berjadual, dan automasi persendirian yang kelayakannya tidak pernah sampai ke pelayar atau klien mudah alih.

  2. 02

    OAuth 2.0

    Sesuai untuk apl pihak ketiga yang memerlukan persetujuan pengguna dan akses terperinci serta boleh dibatalkan kepada akaun s.id.

  3. 03

    MCP

    Pelayan MCP s.id yang dihoskan mendedahkan alat JSON-RPC melalui satu endpoint. Klien boleh disahkan dengan API key atau token akses OAuth 2.0 yang sama seperti digunakan oleh REST API dan menemui metadata kebenaran melalui RFC 9728.

Lancarkan integrasi pertama anda.

Kelayakan adalah berskop. Jika skop yang diperlukan tiada, respons ialah 403 insufficient_scope. Minta hanya kebenaran yang diperlukan oleh integrasi anda.