ShortURL.bot 公共 API 是服务器到服务器的工作区接口，可管理链接、二维码、页面、洞察、用量、表单和转化。它与网页控制台共用订阅权益和用量计数，因此不能通过 API 绕过套餐限制或获得独立额度。
1. 创建并限定 API 密钥
在设置 → API 密钥中创建。所有套餐都可创建密钥；密钥归属订阅，并可限定到全部或指定工作区。密钥只显示一次，请存入服务器端密钥管理器，不要放进浏览器代码、移动应用、源码库或日志。
生产基址为 https://api.shorturl.bot/v1。使用 Authorization: Bearer <api_key>，并先调用 GET /workspaces 获取可访问的工作区 ID。
2. 在工作区创建链接
curl -X POST "https://api.shorturl.bot/v1/workspaces/WORKSPACE_ID/links" -H "Authorization: Bearer $SHORTURL_API_KEY" -H "Content-Type: application/json" -d '{"targetUrl":"https://example.com/launch","backHalf":"launch","tags":["email"]}'成功返回 201 和链接资源。省略 domain 即使用平台默认域名；2s.gg 等已退役第一方域名只支持历史资源。
3. 按权益和错误设计
- 所有套餐：API 密钥、普通链接创建、标签、UTM 和自定义后缀，受订阅周期额度限制。
- Go 及以上：状态控制和最多 500 项的批量创建，并消耗普通链接额度。
- Plus 及以上：更新目标、计划、到期、到期后跳转和密码保护。
- 系统限制：除套餐额度外，每 IP 每分钟最多 800 个公共 API 请求。
401 表示密钥缺失或无效，403 表示工作区、功能、数据或参数被拒绝，429 表示额度或速率限制。只对暂时性失败使用有限指数退避。
下一步
完整结构请查看开发者参考。