Zagl标志

API 文档

直接在代码里缩短链接。一个接口，一个 bearer 令牌。

接口地址

POSThttps://za.gl/api/shorten
RESTJSON 请求体Bearer 认证

身份验证

把你的 API 令牌当作 bearer 令牌，放进 Authorization 请求头。创建第一条链接后，在账号面板里就能拿到它。

请求头
Authorization: Bearer YOUR_API_TOKEN

还没有令牌？不带令牌也能调用。Za.gl 会当场创建一个匿名账号，并返回一个新令牌，位置在 data.newAuthToken. 。存好它，以后管理链接要用。

请求体

originalUrl必填

string

要缩短的长链接。不写协议的话，会自动补上 https://。

customAlias

string

你自己定的后缀，比如 za.gl/my-link。必须唯一，否则返回 409。

password

string

给链接加密码，访客要输入密码才能继续。

expiresAt

string (ISO date)

链接失效的时间点。必须是将来的时间。

expiresInMinutes / expiresInHours / expiresInDays

number

expiresAt 的替代写法，过多久之后失效。

waitTimer

number (0-300)

跳转前访客在预览页等待的秒数。

customGtmId

string

你自己的 Google Tag Manager ID（GTM-XXXXXXX），在预览页触发。

title / description

string

可选的元数据，跟链接一起保存。

generateQR

boolean

同时返回短链接的 QR 码。

请求示例

POSTcURL
curl -X POST https://za.gl/api/shorten \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "password": "optional-secret",
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "waitTimer": 5
  }'

响应示例

调用成功返回 200 OK ，短链接在这个字段里： data.shortUrl.

200 OKJSON
{
  "success": true,
  "message": "URL shortened successfully",
  "data": {
    "id": "123",
    "alias": "my-link",
    "shortUrl": "https://za.gl/my-link",
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "domain": "za.gl",
    "title": "",
    "description": null,
    "hasPassword": true,
    "isActive": true,
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "hits": 0,
    "waitTimer": 5,
    "created": "2026-06-25T10:00:00.000Z",
    "modified": "2026-06-25T10:00:00.000Z",
    "authToken": "your-account-token"
  }
}

速率限制与错误

10 req/min每个客户端每分钟最多 10 次请求。
409这个自定义后缀已被占用。
400链接无效，或者过期时间已经过了。
429触发了速率限制，或者用完了当月配额。