开发者 API 文档
快速接入 51短网址 短链接生成能力，实现自动化操作
接口说明
欢迎使用 51短网址 开放 API。通过调用我们的 API，您可以将短链接生成和管理功能无缝集成到您的自有产品或自动化工作流中。
获取 API 凭证
在开始调用之前，您需要在 账号设置 中生成您的 API Key。 所有的 API 请求都需要在请求头中携带该凭证进行身份验证。
请妥善保管您的 API Key，切勿在前端代码（如 JavaScript）或公开的代码仓库中直接暴露。如发现泄露，请立即前往账号设置重置。
1. 生成短链接
POST /api/link/create
请求头部 (Headers)
| Header 参数 | 是否必填 | 说明 |
| Authorization | 必填 | Bearer {您的 API Key} |
| Content-Type | 必填 | application/json |
请求参数 (Body JSON)
| 参数名 | 类型 | 是否必填 | 说明 |
| long_url | String | 必填 | 需要缩短的原始长链接，需以 http:// 或 https:// 开头 |
| title | String | 选填 | 短链接备注/标题，便于在后台区分 |
| custom_code | String | 选填 | 自定义短链接后缀（需 VIP 权限）。5位及以上，限字母和数字 |
请求示例
curl -X POST https://51dwz.com/api/link/create \
-H "Authorization: Bearer YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"long_url": "https://www.example.com/very/long/path/to/page",
"title": "API 测试生成",
"custom_code": "myapi"
}'
响应示例
{
"status": true,
"msg": "短网址生成成功",
"data": {
"short_url": "https://51dwz.com/myapi",
"short_code": "myapi",
"expires_at": "2026-10-01 12:00:00"
}
}
2. 获取短链接列表
GET /api/link/lists
请求参数 (Query String)
| 参数名 | 类型 | 是否必填 | 说明 |
| limit | Int | 选填 | 返回条数，默认 20，最大 100 |
| offset | Int | 选填 | 偏移量，用于分页，默认 0 |
| keyword | String | 选填 | 搜索关键词（匹配短链接或原链接） |
请求示例
curl -X GET "https://51dwz.com/api/link/lists?limit=10&offset=0" \
-H "Authorization: Bearer YOUR_API_KEY_HERE"
3. 读取数据统计
GET /api/link/stats
请求参数 (Query String)
| 参数名 | 类型 | 是否必填 | 说明 |
| code | String | 必填 | 短链接特征码（如 myapi） |
4. 删除短链接
POST/GET /api/link/delete
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
| code | String | 必填 | 需要删除的短链接特征码 |