短链接 API - 文档

用于创建与查询短链接的 JSON API。请使用为您的账户签发的 API 密钥（如适用也可使用平台的 API_TOKEN）。

公开 API：https://anyurl.bond；JSON 路径前缀 /api/v1/。

Authorization

Authorization: Bearer 1234

将我们提供的 API 密钥放在 Authorization: Bearer 中发送。控制台登录需同时使用该密钥与您的邮箱。

POST /api/v1/shorten

{"long_url":"https://example.com","expiration_time":"24h","max_uses":100,"allow_bots":false}
{"long_url":"https://example.com","permanent":true}

付费套餐可使用可选的 expiration_time（时长或 ISO 日期）与 max_uses。未付费 API 每自然月（UTC，1 日重置）有新建短链上限，且每条约在 10 分钟后过期，与请求体无关。

GET /api/v1/info/{short_code}

返回短码的元数据与有效性，不增加点击次数。

GET /api/v1/me

返回您的方案等级、控制台生效的限额与本月（UTC）用量（新建链接与 API 修改次数）。

GET /api/v1/links

?limit=50&offset=0

仅列出当前 API 密钥创建的短链接（与 GET /info 可见范围一致；owner_id 对应该密钥）。平台 API 令牌不能调用此接口。查询参数：limit（默认 50，最大 100）、offset（默认 0，最大 100000）。响应 JSON：links（每项字段同 GET /info）、total、limit、offset。列表不会删除数据或增加点击。

PUT / PATCH /api/v1/info/{short_code}

{"long_url":"https://example.com/new","expiration_time":"24h","max_uses":20,"allow_bots":false}

修改已有短码请对 /api/v1/info/{short_code} 使用 PUT 或 PATCH，不要用 POST /shorten。请求体（JSON）可含 long_url、expiration_time、max_uses、allow_bots；省略的字段保持不变。expiration_time 置为 "" 可清除定时失效；max_uses 为 -1 表示不限次数。响应形状与 GET /info 一致。

命令行示例（curl）

1234 仅为示例令牌，请换成真实 API 密钥。示例主机：https://anyurl.bond。

POST /api/v1/shorten - 完整 JSON（主机 https://anyurl.bond）
curl 
curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"expiration_time\":\"24h\",\"max_uses\":100,\"allow_bots\":false}"
POST /api/v1/shorten - 最小请求体（付费：默认 24 小时过期）
curl 
curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"
POST /api/v1/shorten - 永久链接（付费；占用一次智能编辑额度）
curl 
curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"permanent\":true}"
GET /api/v1/info/{short_code} - 示例短码 abc123
curl 
curl -sS 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234'
GET /api/v1/me
curl 
curl -sS 'https://anyurl.bond/api/v1/me' \
  -H 'Authorization: Bearer 1234'
GET /api/v1/links - 分页列出您的短链接
curl 
curl -sS 'https://anyurl.bond/api/v1/links?limit=50&offset=0' \
  -H 'Authorization: Bearer 1234'
PATCH /api/v1/info/{short_code}
curl 
curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated-destination\"}"
PUT /api/v1/info/{short_code}
curl 
curl -sS -X PUT 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated\",\"expiration_time\":\"7d\",\"max_uses\":50,\"allow_bots\":true}"
Verbose (-v) 用于调试
curl 
curl -v -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

免费 API：每个自然月（UTC）最多 100 条新短链，用量在每月 1 日重置；单条链接约 10 分钟后失效。付费套餐使用相同的自然月周期。

返回首页 · 条款与条件