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