核心用法
Dub Links API Skill 封装了 Dub.co 平台的短链接管理能力，专注于 /links* 端点族。用户通过 Bearer Token 认证后，可执行单条或批量操作：创建（POST /links）、更新（PATCH /links/{linkId}）、upsert（PUT /links/upsert）、删除（DELETE /links/{linkId}），以及查询类操作——单条检索（GET /links/info 支持 domain+key、linkId、externalId 三种维度）、分页列表（GET /links）、计数（GET /links/count）。批量接口支持最高 100 条/批次，涵盖创建（POST /links/bulk）、更新（PATCH /links/bulk）和删除（DELETE /links/bulk）。建议工作流为：识别意图 → 校验最小输入（如 url、linkId 或筛选条件）→ 执行 curl -s 请求并 jq 解析 → 返回精简摘要（优先展示 shortLink、url、archived 状态）。
显著优点
- 语义完备的 upsert：
PUT /links/upsert可根据 URL 自动判断更新或创建，避免重复与冲突。 - 高效批量处理：三类批量端点均支持 100 条上限，适合大规模导入、归档或清理场景。
- 多维度检索：单条查询支持 domain+key、linkId、externalId，便于与外部系统 ID 映射。
- 灵活筛选与排序：列表接口提供
search、tagId(s)、folderId、tenantId及sortBy/sortOrder，满足复杂分页需求。
潜在缺点与局限性
- 范围严格受限：明确排除 analytics、events、conversions、domains、folders、tags、tokens 等端点，无法满足统计报表或域名管理需求。
- 批量上限锁死：100 条/批次对超大规模数据集仍需客户端分页循环。
- 认证依赖单一：仅支持 Bearer Token；无 OAuth 2.0 或细粒度权限分级说明，需用户自行保管密钥。
- 错误处理责任外置：需调用方自行实现 429 退避、网络重试（建议最多 2 次）及 422 参数校验。
适合人群
- 需要将短链接能力集成至内部工具、CLI 或自动化工作流（如 CI/CD、营销自动化）的开发者与 DevOps。
- 管理大量营销链接、需批量归档或更新的运营团队。
- 希望用外部 ID（
externalId）打通自有数据库与 Dub 链接体系的 SaaS 构建者。
常规风险
- 密钥泄露风险：
DUB_API_KEY需以环境变量或密文管理，避免硬编码；泄露可能导致链接被恶意篡改或删除。 - 误删与批量操作不可逆：
DELETE /links/bulk无回收站机制，建议操作前执行GET /links/count或备份关键linkId。 - Rate Limit 与可用性：未明确公开 QPS/TPS 上限，生产环境需实现指数退避及熔断。
- 数据归属边界：所有操作作用于当前 Bearer Token 绑定的 workspace，跨 workspace 数据隔离需用户自行确认。