Langkau ke kandungan utama
s.id Logo
Markdown ကြည့်ရန်

API v2 Shortener

သင့်အက်ပ်မှ လင့်ခ်တိုများ ဖန်တီးပြီး စီမံပါ။ Base URL: https://api.s.id/v2။ လက်ရှိဗားရှင်း 2.0.0 ဖြစ်ပြီး အပြည့်အစုံ သတ်မှတ်ချက်ကို OpenAPI ပုံစံဖြင့် ရနိုင်ပါသည်။

အပြန်အလှန် ကိုးကားချက်

အထောက်အထား

API key sk_live_... atau OAuth 2.0 access token kirimkan dalam header Authorization: Bearer. API key dibuat di Dashboard > Developer; setiap key hanya boleh menggunakan scope yang Anda pilih.

Skopဝင်ရောက်ခွင့်
links:readSenaraikan dan baca pautan
links:writeCipta dan kemas kini pautan (cipta, edit, pulihkan)
links:archiveArkibkan pautan
links:analyticsBaca statistik klik setiap pautan dan jumlah sepanjang masa
http
Authorization: Bearer sk_live_...

အထောက်အထား လမ်းညွှန်အပြည့်အစုံ

လင့်ခ် ဖန်တီးခြင်း

ဦးတည်ရာ URL ဖြင့် POST /links ပို့ပါ။ custom_slug ကို မဖြည့်ပါက slug ကို အလိုအလျောက် ဖန်တီးပါမည်။

bash
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]"}'
Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
long_urlstringဟုတ်ကဲ့URL destinasi
titlestringမဟုတ်ပါTajuk pautan
custom_slugstringမဟုတ်ပါSlug tersuai; dijana secara automatik jika kosong
passwordstringမဟုတ်ပါKata laluan yang melindungi pautan
expired_atintegerမဟုတ်ပါMasa tamat sebagai cap waktu Unix (saat)
domain_aliasstringမဟုတ်ပါDomain tersuai yang digunakan selain s.id

ဥပမာ တုံ့ပြန်ချက်:

json
{
  "data": {
    "id": 123,
    "short": "[your-alias]",
    "short_url": "https://s.id/[your-alias]",
    "long_url": "https://example.com/long-url",
    "microsite": false,
    "protected": false,
    "disposable": false,
    "adult": false
  },
  "message": "link_created"
}

အဆုံးမှတ်များ

ဤစာမျက်နှာပေါ်တွင်သာ ပြန်လည်တင်သည်အထိ သိမ်းထားပါသည်။ ပြီးလျှင် ရှင်းလင်းပါ။

User

GET/user

URL asas: https://api.s.id/v2 · Skop: user:read

Respons

ကုဒ်ရှင်းလင်းချက်
200User profile
401Missing or invalid API key
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: user:read

Simpan API key anda di atas untuk menghantar permintaan.

GET/quota

Returns the authenticated user's current plan limits and usage counters.

URL asas: https://api.s.id/v2 · Skop: user:read

Respons

ကုဒ်ရှင်းလင်းချက်
200Account quota
401Missing or invalid API key
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: user:read

Simpan API key anda di atas untuk menghantar permintaan.

QR

GET/qr

Returns the account-level (global) QR code settings applied to QR codes by default.

URL asas: https://api.s.id/v2 · Skop: qr:read

Respons

ကုဒ်ရှင်းလင်းချက်
200Global QR settings
401Missing or invalid API key
403API key lacks the required scope
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: qr:read

Simpan API key anda di atas untuk menghantar permintaan.

PUT/qr

Updates the account-level (global) QR code settings. All fields are optional; omitted fields are left unchanged.

URL asas: https://api.s.id/v2 · Skop: qr:write

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
logostringမဟုတ်ပါURL of the logo image embedded in the QR code
colorstringမဟုတ်ပါForeground color as a hex value, e.g. #1a56db

Respons

ကုဒ်ရှင်းလင်းချက်
200Updated global QR settings
401Missing or invalid API key
403API key lacks the required scope
422Request validation failed
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: qr:write

Simpan API key anda di atas untuk menghantar permintaan.

GET/links/{short}/qr

Returns the QR code settings for a single link.

URL asas: https://api.s.id/v2 · Skop: qr:read

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
shortpathstringဟုတ်ကဲ့The short code of the link

Respons

ကုဒ်ရှင်းလင်းချက်
200Link QR settings
401Missing or invalid API key
403API key lacks the required scope
404Resource not found
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: qr:read

Simpan API key anda di atas untuk menghantar permintaan.

PUT/links/{short}/qr

Updates the QR code settings for a single link. All fields are optional; omitted fields are left unchanged.

URL asas: https://api.s.id/v2 · Skop: qr:write

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
shortpathstringဟုတ်ကဲ့The short code of the link

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
logostringမဟုတ်ပါURL of the logo image embedded in the QR code
colorstringမဟုတ်ပါForeground color as a hex value, e.g. #1a56db

Respons

ကုဒ်ရှင်းလင်းချက်
200Updated link QR settings
401Missing or invalid API key
403API key lacks the required scope
404Resource not found
422Request validation failed
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: qr:write

Simpan API key anda di atas untuk menghantar permintaan.

Microsites

GET/microsites

Returns a paginated list of microsites owned by the authenticated user.

URL asas: https://api.s.id/v2 · Skop: microsites:read

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
limitqueryintegerမဟုတ်ပါ
afterquerystringမဟုတ်ပါCursor for the next page (opaque string from previous response)

Respons

ကုဒ်ရှင်းလင်းချက်
200List of microsites
401Missing or invalid API key
403API key lacks the required scope
စမ်းသုံးကြည့်ပါSkop: microsites:read

Simpan API key anda di atas untuk menghantar permintaan.

POST/microsites

URL asas: https://api.s.id/v2 · Skop: microsites:write

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugstringဟုတ်ကဲ့URL-safe identifier (alphanumeric + hyphens/underscores)
titlestringဟုတ်ကဲ့
kindstringဟုတ်ကဲ့Microsite category (e.g. personal_branding, brand, other)
themestringမဟုတ်ပါTheme slug (optional, defaults to the platform default)

Respons

ကုဒ်ရှင်းလင်းချက်
200Microsite created
400Validation error (slug already taken, quota exceeded, etc.)
401Missing or invalid API key
403API key lacks the required scope
စမ်းသုံးကြည့်ပါSkop: microsites:write

Simpan API key anda di atas untuk menghantar permintaan.

GET/microsites/{slug}

URL asas: https://api.s.id/v2 · Skop: microsites:read

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugpathstringဟုတ်ကဲ့

Respons

ကုဒ်ရှင်းလင်းချက်
200Microsite detail
401Missing or invalid API key
403API key lacks the required scope
404Microsite not found
စမ်းသုံးကြည့်ပါSkop: microsites:read

Simpan API key anda di atas untuk menghantar permintaan.

PUT/microsites/{slug}

Patches title, description, and/or visibility. All fields are optional.

URL asas: https://api.s.id/v2 · Skop: microsites:write

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugpathstringဟုတ်ကဲ့

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
titlestringမဟုတ်ပါ
descriptionstringမဟုတ်ပါ
hidebooleanမဟုတ်ပါSet true to hide the microsite from public (requires plan that supports visibility toggle)

Respons

ကုဒ်ရှင်းလင်းချက်
200Updated microsite
401Missing or invalid API key
403API key lacks the required scope
404Microsite not found
စမ်းသုံးကြည့်ပါSkop: microsites:write

Simpan API key anda di atas untuk menghantar permintaan.

DELETE/microsites/{slug}

URL asas: https://api.s.id/v2 · Skop: microsites:delete

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugpathstringဟုတ်ကဲ့

Respons

ကုဒ်ရှင်းလင်းချက်
200Microsite deleted
401Missing or invalid API key
403API key lacks the required scope
404Microsite not found
စမ်းသုံးကြည့်ပါSkop: microsites:delete

Simpan API key anda di atas untuk menghantar permintaan.

POST/microsites/available

Checks whether a microsite slug is available before creating a microsite.

URL asas: https://api.s.id/v2 · Skop: microsites:read

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugstringဟုတ်ကဲ့

Respons

ကုဒ်ရှင်းလင်းချက်
200Slug availability result
401Missing or invalid API key
403API key lacks the required scope
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: microsites:read

Simpan API key anda di atas untuk menghantar permintaan.

GET/microsites/{slug}/components

Returns the components belonging to a microsite, in display order.

URL asas: https://api.s.id/v2 · Skop: microsites:read

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugpathstringဟုတ်ကဲ့The slug of the microsite

Respons

ကုဒ်ရှင်းလင်းချက်
200List of microsite components
401Missing or invalid API key
403API key lacks the required scope
404Resource not found
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: microsites:read

Simpan API key anda di atas untuk menghantar permintaan.

POST/microsites/{slug}/components

Adds a new component to a microsite. The body is { kind, data, tag? }. The shape of the data object depends on kind. Unknown fields are ignored, validation is per-kind, and invalid input returns 422. All color fields are hex strings (e.g. #1a56db). **Kinds:** PROFILE, LINK, HORIZONTAL_LINK, TEXT, IMAGE, MEDIA, DIVIDER, COUNTDOWN, MAPS, IMAGE_SLIDE, CV, AUTOPLAY_MUSIC, CONTACT, CALENDAR, SHOP_LISTING, SHOP_ITEM, SHOP_LEADERBOARD. **Rules:** - PROFILE, CV and AUTOPLAY_MUSIC are unique — at most one per microsite. - IMAGE_SLIDE requires a plan with the Image Slide feature. - On create the password is always stored empty — set or change it via update (PUT). - Image fields (image, imageBackground, slide image) must be a local asset path, not a remote URL — they must match [/.a-zA-Z0-9_-]+.(jpg|jpeg|png|svg|webp|gif|bmp); any value containing a scheme (https://), //, or .. is rejected. **Shared field groups** (a kind that lists a group accepts all of its fields inside data): - **Button styling** (LINK, CONTACT, CALENDAR): icon (string, max 255), textFont (string, max 100), textPosition (string, max 100), buttonEffect (string, max 100), buttonColor (hex, max 20), buttonBorderColor (hex, max 20), buttonIconBackground (hex, max 20), buttonShadowColor (hex, max 20). - **Spoiler reveal** (TEXT, IMAGE, MEDIA, MAPS, IMAGE_SLIDE, SHOP_LEADERBOARD): isSpoiler (bool), spoilerButtonText (string, max 140), spoilerButtonTextPosition (string, max 100), spoilerButtonIcon (string), spoilerButtonColor (hex, max 20), spoilerButtonFont (string, max 100), spoilerBackground (string, max 100), spoilerBackgroundOpacity (string, max 100), spoilerButtonBorderColor (hex, max 20), spoilerButtonIconBackground (hex, max 20), spoilerButtonShadowColor (hex, max 20). - **Password protection** (LINK, TEXT, IMAGE, MEDIA, MAPS, IMAGE_SLIDE, CONTACT, CV, SHOP_LEADERBOARD): passwordActive (bool), password (string, max 255 — set via update only), passwordMessage (string, max 255).

URL asas: https://api.s.id/v2 · Skop: microsites:write

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugpathstringဟုတ်ကဲ့The slug of the microsite

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
kindPROFILE | LINK | HORIZONTAL_LINK | TEXT | IMAGE | MEDIA | DIVIDER | COUNTDOWN | MAPS | IMAGE_SLIDE | CV | AUTOPLAY_MUSIC | CONTACT | CALENDAR | SHOP_LISTING | SHOP_ITEM | SHOP_LEADERBOARDဟုတ်ကဲ့Component kind. The shape of data depends on this value.
dataobjectဟုတ်ကဲ့Kind-specific component data. Its shape depends on kind. See the operation description and examples below.
tagstringမဟုတ်ပါOptional grouping tag

Respons

ကုဒ်ရှင်းလင်းချက်
200Component created
401Missing or invalid API key
403API key lacks the required scope
404Resource not found
422Request validation failed
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: microsites:write

Simpan API key anda di atas untuk menghantar permintaan.

PUT/microsites/{slug}/components/{componentId}

Updates a single microsite component.

URL asas: https://api.s.id/v2 · Skop: microsites:write

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugpathstringဟုတ်ကဲ့The slug of the microsite
componentIdpathstringဟုတ်ကဲ့The component ID

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
activebooleanဟုတ်ကဲ့Whether the component is shown
kindstringဟုတ်ကဲ့Component kind (e.g. LINK, PROFILE, TEXT)
dataobjectဟုတ်ကဲ့Kind-specific component data

Respons

ကုဒ်ရှင်းလင်းချက်
200Component updated
401Missing or invalid API key
403API key lacks the required scope
404Resource not found
422Request validation failed
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: microsites:write

Simpan API key anda di atas untuk menghantar permintaan.

DELETE/microsites/{slug}/components/{componentId}

Deletes a single microsite component.

URL asas: https://api.s.id/v2 · Skop: microsites:delete

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugpathstringဟုတ်ကဲ့The slug of the microsite
componentIdpathstringဟုတ်ကဲ့The component ID

Respons

ကုဒ်ရှင်းလင်းချက်
200Component deleted
401Missing or invalid API key
403API key lacks the required scope
404Resource not found
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: microsites:delete

Simpan API key anda di atas untuk menghantar permintaan.

POST/microsites/{slug}/components/order

Reorders a microsite's components according to the provided list of component IDs.

URL asas: https://api.s.id/v2 · Skop: microsites:write

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
slugpathstringဟုတ်ကဲ့The slug of the microsite

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
ordersstring[]ဟုတ်ကဲ့Component IDs in the desired display order

Respons

ကုဒ်ရှင်းလင်းချက်
200Components reordered
401Missing or invalid API key
403API key lacks the required scope
404Resource not found
422Request validation failed
429Too many requests. Per-tier limits apply, resolved from your s.id plan: a per-credential per-minute rate limit (rate_limit_exceeded) and a daily call quota (api_quota_exceeded), both shared across every integration using your credential (sk_live_* key or OAuth token). OAuth apps also have a secondary per-client_id ceiling (client_rate_limit_exceeded) across all their users' tokens. See GET /v2/quota for your current standing, and the X-RateLimit-* / X-Quota-* response headers.
စမ်းသုံးကြည့်ပါSkop: microsites:write

Simpan API key anda di atas untuk menghantar permintaan.

OAuth 2.0

GET/oauth/authorize

A plain browser navigation here (no Accept: application/json) 302-redirects to the dash.s.id consent UI, preserving the query string. With Accept: application/json, returns application name, logo, and requested scopes for the consent UI to render.

URL asas: https://api.s.id

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
client_idquerystringဟုတ်ကဲ့
redirect_uriquerystringဟုတ်ကဲ့
response_typequerycodeဟုတ်ကဲ့
scopequerystringမဟုတ်ပါ
statequerystringမဟုတ်ပါRecommended. Opaque value for CSRF protection. Returned unchanged in the redirect.

Respons

ကုဒ်ရှင်းလင်းချက်
200Consent screen data
400Bad request
POST/oauth/token

URL asas: https://api.s.id

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
grant_typeauthorization_code | refresh_tokenမဟုတ်ပါ
codestringမဟုတ်ပါ
redirect_uristringမဟုတ်ပါ
client_idstringမဟုတ်ပါ
client_secretstringမဟုတ်ပါ
refresh_tokenstringမဟုတ်ပါ

Respons

ကုဒ်ရှင်းလင်းချက်
200Token response
400Invalid grant, unsupported_grant_type, or invalid_client
401Invalid client credentials
POST/oauth/revoke

Revokes an access or refresh token. Always returns 200 OK regardless of whether the token was valid (RFC 7009).

URL asas: https://api.s.id

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
tokenstringဟုတ်ကဲ့

Respons

ကုဒ်ရှင်းလင်းချက်
200Token revoked
POST/oauth/introspect

Reports whether a token is currently active and, if so, which scopes and client it belongs to (RFC 7662). Client-credential protected: client_id/client_secret identify the caller, not the token owner. Always returns 200 — including for an unknown, expired, or revoked token ({"active": false}) — to avoid leaking token validity to unauthenticated probing.

URL asas: https://api.s.id

Badan permintaan

Medanအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
tokenstringဟုတ်ကဲ့
client_idstringဟုတ်ကဲ့
client_secretstringဟုတ်ကဲ့

Respons

ကုဒ်ရှင်းလင်းချက်
200Introspection result
400Missing token/client_id, or invalid client credentials
GET/oauth/userinfo

Returns the profile of the user who authorized the OAuth app. Requires Authorization: Bearer <access_token> (the OAuth access token, not an sk_live_ key).

URL asas: https://api.s.id · Skop: user:read

Respons

ကုဒ်ရှင်းလင်းချက်
200User profile
401Unauthorized
GET/.well-known/oauth-authorization-server

RFC 8414 discovery document advertising every OAuth endpoint URL, supported scopes, and PKCE methods, so standards-compliant client libraries can configure themselves instead of hard-coding s.id's URLs.

URL asas: https://api.s.id

Respons

ကုဒ်ရှင်းလင်းချက်
200Authorization server metadata
GET/api/user/oauth/apps

Returns all OAuth clients that have active tokens for the authenticated user. Auth: user session cookie (not API key).

URL asas: https://api.s.id

Respons

ကုဒ်ရှင်းလင်းချက်
200List of connected apps
401Unauthorized
DELETE/api/user/oauth/apps/{clientId}

Revokes all active tokens granted by the current user to the specified OAuth client.

URL asas: https://api.s.id

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
clientIdpathstringဟုတ်ကဲ့

Respons

ကုဒ်ရှင်းလင်းချက်
200App access revoked
401Unauthorized
404App not found

Analytics

GET/stats

Returns a timeline of clicks plus breakdowns by top links, referers, locations, devices, and browsers for the authenticated account. Date range is gated by subscription plan.

URL asas: https://api.s.id/v2 · Skop: links:analytics

Parameter

MedanLokasiအမျိုးအစားလိုအပ်သည်ရှင်းလင်းချက်
startquerystringမဟုတ်ပါStart date (YYYY-MM-DD). Defaults to 30 days ago.
endquerystringမဟုတ်ပါEnd date (YYYY-MM-DD). Defaults to today.
additionalquerybooleanမဟုတ်ပါInclude referer, location, device, browser breakdowns

Respons

ကုဒ်ရှင်းလင်းချက်
200Account analytics
401Missing or invalid API key
403API key lacks the required scope
စမ်းသုံးကြည့်ပါSkop: links:analytics

Simpan API key anda di atas untuk menghantar permintaan.

ကန့်သတ်ချက်နှင့် အမှားများ

အထောက်အထား တစ်ခုစီကို တစ်မိနစ်အလိုက် ကန့်သတ်ထားပါသည်။ သင့်ကြိမ်ရေကို GET /quota ဖြင့် စစ်ပါ။

အထောက်အထားကန့်သတ်ချက်
API key သို့မဟုတ် OAuth access tokenတစ်မိနစ်လျှင် 38 ကြိမ်
OAuth အက်ပ် (token အားလုံး စုပေါင်း)တစ်မိနစ်လျှင် 500 ကြိမ်
ကုဒ်အဓိပ္ပာယ်
400Permintaan rosak atau tidak disokong
401Kelayakan hilang, tidak sah, dibatalkan atau tamat tempoh
403Kelayakan tidak mempunyai skop yang diperlukan
404Sumber yang diminta tidak ditemui
422Pengesahan permintaan gagal
429Had kadar telah dilebihi