# 프로모션 코드 프로모션용 코드 생성하기

프로모션 코드 프로모션용 코드를 생성합니다.

코드 생성에 관한 지침:

* 프로모션당 코드 총 수량에 대한 상한은 없으나, 각 요청당 코드 수는 50,000개로 제한됩니다. 이 수량을 초과하는 요청은 422 Unprocessable Entity 오류가 반환됩니다. 50,000개 이상의 코드가 필요한 경우, 여러 번에 걸쳐 요청을 보내주십시오.

* 안정성을 높이기 위해, 요청당 최대 10,000개까지 소량씩 코드를 생성하는 것이 권장합니다. 예를 들어, 100,000개의 코드를 생성하려면 "count": 50000을 지정하여 2번의 요청을 보내는 대신, "count": 10000을 지정하여 10번의 요청을 보내십시오. 각 요청에 대한 성공 응답을 받은 후에 다음 요청을 보내십시오.

* 초당 15건의 요청으로 설정된 요청 제한에 유의하시기 바랍니다. 대량의 요청 생성 시 요청 제한을 초과하여 429 오류가 발생하지 않도록 요청을 순차적으로 전송하십시오.

* 코드 목록을 가져오려면 프로모션 코드 목록 조회 메서드를 호출하십시오.

| 매개 변수 | 값 |
|---|---|
| 요청당 최소 코드 수. | 1 |
| 요청당 허용되는 최대 코드 수. 가능한 한 가장 큰 단일 배치 처리가 필요한 경우에만 사용하십시오. | 50,000 |
| 요청당 권장 코드 수. | 최대 10,000개까지입니다. 더 많이 생성해야 하는 경우, 순차적으로 여러 번 요청을 보내주십시오. |

Endpoint: PUT /v2/project/{project_id}/admin/promocode/{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)
    프로모션 외부 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"