メインコンテンツへスキップ
active のクーポンに対して、1–500 個のランダムなプロモーションコードを一度に生成します。同じバッチのコードは同じ制限と batchId を共有し、レスポンスでまとめて返されます。たとえば使い切りコードの CSV としてそのままエクスポートできます。
認証: API Key
必ず X-Idempotency-Key を送信し、同じキーでリトライしてください。 コードはランダムに生成されるため、キーなしでリトライすると 2 つ目のバッチが生成されます。

リクエストボディ

各コードは prefix とランダム部分で構成されます(例:VIP-7KQ2MZ9H3X)。生成されたコードは、同じストア・同じ環境の有効なコードと重複しません。

リクエスト例

成功レスポンス (200)

レスポンスフィールド

エラー

リトライポリシー:4xx は一切リトライしない — リクエストを修正してから再送信。5xx は指数バックオフでリトライ(5s 開始、最大 3 回)。リトライ時は必ず同じ X-Idempotency-Key を使用。