开放平台

开放平台 API 文档

面向系统集成的短链生成与查询接口。公开文档无需登录,实际调用需使用访问密钥签名。

最后更新:

访问密钥与鉴权

AppSecret 仅用于客户端本地计算签名,不得随请求传输。密钥的创建、停用和配额管理仍在登录后的开放平台中完成。

请求头说明
X-App-Id访问密钥的 AppId。
X-App-Timestamp当前 Unix 秒级时间戳,有效期 300 秒。
X-App-Nonce最长 128 字符的随机串,300 秒内不可重复。
X-App-Signature使用 AppSecret 计算的 HMAC-SHA256 hex 签名。
canonical = METHOD + "\n" + REQUEST_URI + "\n" + TIMESTAMP + "\n" + NONCE + "\n" + SHA256(BODY)
signature = HMAC_SHA256(canonical, AppSecret)

REQUEST_URI 需包含原始 query string;空请求体按空字符串计算 SHA256。

公开端点

POST /api/openapi/shortlink/generate

生成单条短链,支持分组、自定义短码、访问控制、随机分流和设备分流。

POST /api/openapi/shortlink/batch

批量生成短链,单次最多 100 条。

GET /api/openapi/shortlink/list

获取当前鉴权用户的短链列表,支持分组筛选和分页。

请求限制与能力边界

  • 单条和批量生成接口每分钟最多 10 次,批量接口单次最多 100 条。
  • 时间戳有效期为 300 秒,同一 AppId 的 nonce 在该时间内不可重复。
  • 本页不公开密钥、用户数据、管理接口或内部实现;实际结果以鉴权请求和当前账号权限为准。
客服微信二维码

添加客服微信

imeilikeai