rdurl API

用代码创建和管理短链接

API 一般信息

所有请求都需要 API 令牌。请参阅认证部分。
基础端点是: https://rdurl.link/api
仅支持 HTTPS。
所有端点都返回 JSON 对象。
请求以 JSON 发送 (Content-Type: application/json)。
所有时间和时间戳相关字段均为毫秒。
所有字符编码均为 UTF-8。

认证

API 通过令牌识别请求属于哪个账户。令牌等同于账户密码：任何持有令牌的人都可以创建和删除该账户的链接。

第 1 步。生成令牌

登录仪表板，从"API 令牌"菜单生成令牌。每次生成都会产生新令牌，且生成后只能查看一次。

第 2 步。在请求中添加令牌

从以下两种方式中任选其一。

1. Authorization: Bearer （推荐）

大多数公开 API 使用的标准认证方式。

curl https://rdurl.link/api/link/create   -H "Authorization: Bearer rd_YOUR_TOKEN"   -H "Content-Type: application/json"   -d '{ "url": "https://example.com/very/long/url" }'

2. x-api-key 请求头

对于不方便使用 Authorization 请求头的工具更便捷。

curl https://rdurl.link/api/link/create   -H "x-api-key: rd_YOUR_TOKEN"   -H "Content-Type: application/json"   -d '{ "url": "https://example.com/very/long/url" }'

第 3 步。验证令牌

运行下面的命令。如果返回链接列表，说明令牌工作正常。

curl https://rdurl.link/api/link/list \
  -H "Authorization: Bearer rd_YOUR_TOKEN"

令牌管理

令牌由 rd_ 加 32 位十六进制字符组成。生成后只能查看一次，请妥善保管。如果怀疑泄露，请立即在仪表板中吊销令牌，吊销后令牌立即失效。

端点

POST /api/link/create

创建短链接。发送 URL 后返回 slug 和短链接。

参数

url要缩短的 URL（必填）
title链接标题（可选，100 字符以内）
folder链接文件夹（可选，100 字符以内 — 可按文件夹筛选列表）
domain自定义域名（可选，如 example.com）

请求

{ "url": "https://example.com/very/long/url" }

响应

{
  "success": true,
  "message": {
    "slug": "abc123",
    "short": "https://rdurl.link/abc123",
    "domain_no": 0,
    "domain": ""
  }
}

GET /api/link/list

分页查询我的链接，每页 20 条。支持搜索和域名筛选。

参数

page页码（默认 1）
domain自定义域名（可选，如 example.com）
search搜索关键词（slug/URL 部分匹配）
folder链接文件夹（可选，100 字符以内 — 可按文件夹筛选列表）

请求

GET /api/link/list?page=1&domain=example.com&search=keyword

响应

{
  "success": true,
  "message": {
    "total": 42,
    "page": 1,
    "list": [
      {
        "slug": "abc123",
        "url": "https://example.com/very/long/url",
        "short": "https://rdurl.link/abc123",
        "clicks": 128,
        "tm": 1789379625000
      }
    ]
  }
}

GET /api/link/info

查询单个链接的详细信息和点击数。

参数

slugslug（必填）
domain自定义域名（可选，如 example.com）

请求

GET /api/link/info?slug=abc123

响应

{
  "success": true,
  "message": {
    "slug": "abc123",
    "url": "https://example.com/very/long/url",
    "short": "https://rdurl.link/abc123",
    "clicks": 128,
    "tm": 1789379625000
  }
}

GET /api/link/stats

链接点击统计 — 查询累计、今日和国家 TOP 10。

参数

slugslug（必填）
domain自定义域名（可选，如 example.com）

请求

GET /api/link/stats?slug=abc123

响应

{
  "success": true,
  "message": {
    "clicks": 128,
    "clicksToday": 5,
    "countries": [
      { "country": "KR", "clicks": 80 },
      { "country": "US", "clicks": 30 }
    ]
  }
}

DELETE /api/link

删除链接。全局链接 30 天内可恢复，自定义域名链接立即彻底删除。

参数

slugslug（必填）
domain自定义域名（可选，如 example.com）

请求

DELETE /api/link
{ "slug": "abc123" }

响应

{ "success": true }

速率限制

每个 IP 每分钟 10 次，每个账户每天最多 1,000 个链接。超出限制返回 429。

错误代码

失败时返回 success: false 和错误代码。

{ "success": false, "message": "api_invalid_token" }

code	status	含义
`api_invalid_token`	401	令牌缺失或无效
`link_invalid_url`	400	URL 无效（仅限 http/https）
`link_invalid_slug`	400	slug 格式无效
`link_not_found`	400	链接不存在
`domain_not_found`	400	自定义域名不存在
`link_own_domain`	400	不能缩短自己的域名
`link_create_failed`	400	链接创建失败
`link_rate_limit`	429	超出请求限制