跳转到主要内容
为一张 active 的优惠券一次生成 1–500 个随机促销码。同一批的码共用相同的附加限制和 batchId,并在响应中一次性全部返回,例如可直接导出为一次性码的 CSV。
认证方式: API Key
务必带上 X-Idempotency-Key,并用同一个键重试。 码是随机生成的,不带键重试会再生成一批。

请求体

每个码由 prefix 加随机部分组成,例如 VIP-7KQ2MZ9H3X。生成的码不会与同一店铺、同一环境的有效码重复。

请求示例

成功响应 (200)

响应字段

错误响应

重试策略:4xx 一律不要重试 — 修正请求后重发。5xx 指数退避重试(起步 5s,最多 3 次)。重试时始终使用同一个 X-Idempotency-Key。