POST /api/v1/links/bulk
提交 items 或 links 数组，每次最多 100 项。
links:bulk:create
API Key 必须包含批量创建权限。
Idempotency-Key
同一批次重试时复用同一个 UUID，避免重复创建和重复扣减额度。
复制并修改
curl、JavaScript 与 Python 示例
替换 API Key 和目标地址；每一项支持单条创建接口的同类字段。
curl -X POST https://tt.vg/api/v1/links/bulk \
-H "Authorization: Bearer ttvg_your_api_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
-d '{
"items": [
{ "destinationUrl": "https://example.com/a", "description": "Campaign A" },
{ "destinationUrl": "https://example.com/b", "key": "campaign-b" }
]
}'响应处理
按条目处理每个结果
同一批次可同时包含成功链接和校验错误。请把返回的 index 与自己的输入记录一起保存。
全部创建成功
读取 items 和 summary，此时 errors 为空。
部分成功
保存成功条目，检查带 index 的错误，并只重试失败输入。
请求或权限错误
修复参数、身份验证、邮箱验证或 scope 后再重试。
额度或频率限制
停止当前批次并等待；如果响应带 Retry-After，请按其时间重试。
临时服务错误
采用指数退避，并使用同一个 Idempotency-Key 重试。
额度与批次上限
每次请求最多 100 条。每个成功条目会消耗账户套餐的一次当日 links:create 额度；失败条目不会算作成功创建。
通过 Webhook 继续处理
可订阅 link.created、link.updated 和 link.clicked。事件异步签名发送，失败时自动重试，不阻塞 API 响应。
常见问题
批量 API 常见问题
批量创建是全部成功或全部失败吗？
不是。前面的有效条目可能成功，后续条目返回带索引的错误；混合结果使用 HTTP 207。
处理中途额度用完会怎样？
当前和剩余条目会收到 429 错误，批次处理随即停止。
如何避免重试产生重复链接？
发送随机 Idempotency-Key，并且只在相同批次的重试中复用这个值。