开放 API

所有接口都在 https://a.qqsb.vip/api/v1 下，返回 JSON。接口仅对开通了 API 权限的套餐开放，调用频率默认 30 次/分钟。

鉴权

把 Token 放在请求头里（也可以作为 `token` 参数提交）。Token 在「API 接口」页面获取，重置后旧的立即失效。

curl -H "Authorization: Bearer 你的 Token" https://a.qqsb.vip/api/v1/me

登录后即可查看自己的 Token。

接口一览

方法	路径	说明
GET	/api/v1/me	查看当前 Token 的身份与套餐额度
POST	/api/v1/shorten	生成短链
GET	/api/v1/links	分页查询我的短链
GET	/api/v1/stats	查询账号或单条链接的访问统计
POST	/api/v1/links/{id}	修改短链的目标地址、备注、有效期
POST	/api/v1/links/{id}/delete	删除短链

生成短链

POST https://a.qqsb.vip/api/v1/shorten，JSON 字段：

url: 必填，原始网址（http/https）
code: 选填，自定义后缀；受套餐最短长度限制，游客不可用
note: 选填，备注，最长 255 字
expires_at: 选填，到期时间，2026-12-31 23:59:59 或 2026-12-31T23:59
max_clicks: 选填，最大点击数，0 为不限

curl -X POST "https://a.qqsb.vip/api/v1/shorten" \
  -H "Authorization: Bearer 你的 Token" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/a-very-long-path","code":"demo","note":"首页"}'

成功返回 201：

{"ok":true,"data":{"id":12,"code":"demo","short_url":"https://m.shabiqq.com/demo","url":"https://example.com/a-very-long-path","is_custom":true,"status":"active","created_at":"2026-10-16 10:00:00"}}

查询短链列表

GET https://a.qqsb.vip/api/v1/links?page=1&per_page=20&kw=关键词&status=active

curl -G "https://a.qqsb.vip/api/v1/links" \
  -d page=1 -d per_page=20 \
  -H "Authorization: Bearer 你的 Token"

返回 data.items 与 data.total / pages / page / per_page，每条含 short_url、clicks、uv、status 等字段。

查询统计

GET https://a.qqsb.vip/api/v1/stats?days=30，带 code=demo 或 id=12 时查单条

curl -G "https://a.qqsb.vip/api/v1/stats" \
  -d days=30 -d code=demo \
  -H "Authorization: Bearer 你的 Token"

返回 PV/UV、按天趋势、设备与来源分布。days 会被套餐的明细保留天数截断。

修改与删除

# 改目标地址（其余字段同上，都是选填）
curl -X POST "https://a.qqsb.vip/api/v1/links/12" \
  -H "Authorization: Bearer 你的 Token" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/new"}'

# 删除
curl -X POST "https://a.qqsb.vip/api/v1/links/12/delete" \
  -H "Authorization: Bearer 你的 Token"

只能操作属于自己的短链，否则会返回 403。

返回与错误码

HTTP	含义
200 / 201	成功；`{"ok":true,"data":{...}}`
400	参数不合法，`message` 里有中文原因
401	Token 缺失或无效
403	套餐无 API 权限、接口被关闭、或操作了别人的短链
404	短链不存在
429	超过频率限制，稍后再试
500	服务器错误，请联系管理员