短链 Agent API

第三方写作 Agent 可在管理员已配置的规则下创建静态短链。公开 URL 只包含项目和随机 slug；平台、内容、发布日期和用户类型仅保存在 GEO 的 SQLite 中。

跳转不会暴露平台、内容、用户类型等归因字段。项目未启用 GEO Tag 时，目标 URL 与规则完全一致；启用后仅临时追加一个不透明 gr。

认证与幂等

使用 Authorization: Bearer <API_KEY>。
每次请求必须提供稳定的 Idempotency-Key；同一 Agent 重试相同请求会得到同一条短链。
不同内容请使用不同幂等键；同一键提交不同参数返回 409。

创建短链

curl -X POST '/api/agent/short-links' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: github:repo:readme-main:2026-08-21' \
  -H 'Content-Type: application/json' \
  --data '{
    "project": "wdcloud",
    "rule_key": "register",
    "platform": "github",
    "item": "readme-main",
    "visitor_type": "public",
    "publish_date": "2026-08-21",
    "enabled": true
  }'

不传 slug 时服务自动生成；需要可读路径时可以传入全项目唯一的 slug。

字段

字段	说明
`project`	项目标识。
`rule_key`	后台规则标识；决定唯一目标 URL。
`slug`	可选短链路径；省略时自动生成。
`platform`	来源平台，例如 github、xiaohongshu、wechat。
`item`	文章、仓库或内容条目标识。
`visitor_type`	public、internal、smoke 或 test。
`publish_date`	内容发布日期，YYYY-MM-DD。

响应示例

{
  "project": "wdcloud",
  "slug": "8f32a19c4b",
  "rule_key": "register",
  "platform": "github",
  "item": "readme-main",
  "visitor_type": "public",
  "publish_date": "2026-08-21",
  "enabled": true,
  "short_path": "/wdcloud/8f32a19c4b",
  "short_url": "https://geo.muxiai.com.cn/wdcloud/8f32a19c4b"
}