Skip to content

Create Short URL

Description

將任意長網址縮短為短網址。常用於降低 QR Code 承載內容長度、使 QR Code 更易掃描。

  • 相同的原始網址重複建立時，會回傳同一個短網址（不會重複產生）。
  • 產生的短網址永久有效。

Resource

POST /v1/shorturl

Authorization

此 API 為公開端點，無需授權。

Request Body Parameters

Name Type Description
url string 欲縮短的原始網址；須為合法的 http/https 網址，長度上限 2048

Request Example

{
    "url": "https://example.com/entry?data=eyJhdXRoa2V5IjogIjdrYW14..."
}

Response Body Parameters

Name Type Description
code string 產生的短碼（7 碼）
short_url string 完整短網址

Response

HTTP-Status-Code: 200 

{
    "code": "AbC12xZ",
    "short_url": "https://<api-domain>/s/AbC12xZ"
}

HTTP-Status-Code: 400 

{
    "message": "缺少必填欄位 原始網址"
}