API

Tool Agent API

让你的 Agent、自动化脚本或内部工作流通过 API key 调用 Ecomwith 工具。当前文档覆盖 GTIN、QR Code、UTM Builder 和 Break-even ROAS API。

认证

在设置页创建 API key。完整密钥只显示一次，请复制到你的 Agent 或密钥管理器，之后页面只会显示脱敏后的 key。

Authorization: Bearer ecw_live_...
X-API-Key: ecw_live_...

额度与限速

API 调用有独立用量记录。每次响应都会返回剩余额度和限速信息，方便你的 Agent 判断是否继续请求。

X-Quota-Limit: 1000
X-Quota-Remaining: 997
X-RateLimit-Limit: 30

安全重试

如果网络超时或 Agent 自动重试，请带上同一个 Idempotency-Key。相同请求编号和相同内容会复用结果，避免重复生成或重复扣量。

Idempotency-Key: order-sync-2026-06-14-001

Endpoints

GTIN API

按数量批量生成 GTIN-14。额度按生成的号码数量计算。

QR Code API

把链接或文本生成 SVG / PNG data URL 二维码。额度按请求次数计算。

UTM Builder API

把一条或多条落地页链接批量加上统一 UTM 参数。额度按成功生成的链接数量计算。

Break-even ROAS API

输入售价、成本、物流、手续费和退款预留，返回盈亏平衡 ROAS、目标利润 ROAS 和 CPA 护栏。

OpenAPI JSON

/api/v1/openapi.json