链小码开放 API 文档

使用 API 批量创建短链、查询数据、管理域名与分组，快速接入您的业务系统。

快速开始查看接口
Base URL
https://api.lianxiaoma.com
Auth
Authorization: Bearer <API_KEY>

快速开始

  1. 在控制台创建并复制 API Key
  2. 在请求头中携带 Authorization
  3. 调用接口创建短链或查询数据
示例：创建短链
curl -X POST "https://api.lianxiaoma.com/v1/short-links" \\\n+  -H "Authorization: Bearer <API_KEY>" \\\n+  -H "Content-Type: application/json" \\\n+  -d "{\"url\":\"https://www.example.com/very/long/url\",\"group\":\"默认分组\"}"

鉴权与签名

链小码 API 使用 Bearer Token 鉴权。请妥善保管 API Key，不要暴露在前端代码或公开仓库。

建议
  • 仅在服务端调用 API
  • 定期轮换 API Key
  • 为不同业务分配不同 Key（便于审计）

接口列表

创建一条短链接，支持分组、备注等参数。

请求示例
POST /v1/short-links\nAuthorization: Bearer <API_KEY>\nContent-Type: application/json\n\n{\n  "url": "https://www.example.com/very/long/url",\n  "group": "默认分组"\n}

错误码

错误码含义建议处理
401未授权 / API Key 无效检查 Authorization 头是否正确，确认 Key 可用
403无权限访问该资源确认套餐/权限开通，或联系管理员授权
429请求过于频繁降低调用频率并做重试/退避
500服务端异常稍后重试；持续出现请联系客服并提供请求 ID

常见问题

支持。绑定自有域名后，可在创建短链时指定域名参数（以控制台配置为准）。