开放 API v1
使用付费套餐的 API Token 创建、查询和统计短链。所有请求与响应均使用 UTF-8 JSON。
接入信息
Base URL
https://short.24cod.com/api/v1频率限制
每个 Token 60 次/分钟
内容类型
application/json批量上限
100 条/次
认证
在控制台创建 Token 后，将它直接放入 HTTP Authorization 请求头，无需 Secret：
Authorization: Bearer YOUR_API_TOKENToken 代表账号接口权限，请存入服务端密钥管理系统，不要放入浏览器或客户端代码。
接口列表
POST
/links创建短链。必填 url；可选 code、title、remark、password、expire_time、domain_id。省略 domain_id 时优先使用非兜底平台域名，只有无其他可用域名时才使用 short.24cod.com。
curl -X POST 'https://short.24cod.com/api/v1/links' \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"url":"https://example.com/page","code":"Promo2026","expire_time":1798761600}'GET
/links?page=1&limit=20分页查询当前 Token 所属账号的短链；limit 最大为 100。
GET
/links/{code}按短码查询详情，包括原链接、状态、有效期、访问量和二维码地址。
GET
/links/{code}/stats?days=7查询 1-90 天访问趋势、独立访客、设备和地域分布；实际范围受套餐日志天数约束。
POST
/links/batch批量创建。urls 可为 URL 字符串数组，也可使用 items 传递完整参数对象数组。
未传 domain_id 时，每条短链都会优先使用其他可用平台域名；只有当前仅剩 short.24cod.com 可用时，才使用该兜底域名。
{"urls":["https://example.com/a","https://example.com/b"]}响应结构
{
"code": 1,
"msg": "创建成功",
"time": 1784000000,
"data": {
"code": "Promo2026",
"short_url": "https://c.eqeuvas.cn/Promo2026",
"qrcode_url": "https://short.24cod.com/index/dwz/qrcode?id=123"
}
}HTTP 错误码
| 状态 | 说明 |
|---|---|
| 400 | 参数、JSON 或业务校验失败 |
| 401 | Bearer Token 缺失、错误或已禁用 |
| 403 | 套餐 API 权限失效 |
| 404 | 短链不存在 |
| 429 | 超过频率限制，并返回 Retry-After |