# クーポンコードを生成

クーポンコードを生成します。

コード生成に関するガイドライン：

* プロモーションあたりのコードの最大総数に制限はありませんが、1回のリクエストの上限は50,000コードです。これより多い数を指定したリクエストは、422 Unprocessable Entityエラーを返します。50,000コード以上必要な場合は、複数回に分けてリクエストを送信してください。

* 信頼性を高めるため、1回のリクエストにつき最大10,000コードまでの、より小さなバッチに分けてコードを生成することをお勧めします。例えば、100,000コードを作成する場合、"count": 50000で2回送信するのではなく、"count": 10000で10回リクエストを送信します。次のリクエストを送信する前に、各リクエストが正常な応答を返したことを確認してください。

* 1秒あたり15リクエストに設定されているレート制限にご留意ください。大量のコードを生成する場合は、レート制限を超過して429エラーが発生するのを防ぐため、リクエストを順次送信してください。

* コードのリストを取得するには、クーポンコードを取得するメソッドを呼び出します。

| パラメータ | 値 |
|---|---|
| 1回のリクエストあたりの最小コード数。 | 1 |
| 1回のリクエストあたりの最大コード数。可能な限り最大の単一バッチ塊が必要な場合にのみ使用してください。 | 50,000 |
| 1回のリクエストあたりの推奨コード数。| 最大10,000まで。これ以上の数を作成する必要がある場合は、リクエストを順次送信してください。|

Endpoint: PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横、またはプロジェクトの作業中にブラウザのアドレスバーで確認できます。URLの形式は以下の通りです：https://publisher.xsolla.com//projects/。
    Example: 44056

  - `external_id` (integer, required)
    プロモーションexternal ID。プロジェクト内での一意のプロモーション識別子。
    Example: "coupon_44056_1"

## Request fields (application/json):

  - `count` (integer, required)

## Response 200 fields (application/json):

  - `count` (integer)

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

## Response 404 fields (application/json):

  - `statusCode` (integer)
    Example: 404

  - `errorCode` (integer)
    Example: 4001

  - `errorMessage` (string)
    Example: "[0401-9802]: Promocode not found"

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"