# Generar códigos de cupón

Genera códigos de cupón.

Directrices para la generación de códigos:

* No hay un número máximo total de códigos por promoción, pero cada solicitud está limitada a 50 000 códigos. Las solicitudes con un número superior devuelven el error 422 Unprocessable Entity. Si necesita más de 50 000 códigos, envíe varias solicitudes.

* Para una mayor fiabilidad, recomendamos generar los códigos en lotes más pequeños, de hasta 10 000 por solicitud. Por ejemplo, para crear 100 000 códigos, envíe 10 solicitudes con "count": 10000 en lugar de 2 solicitudes con "count": 50000. Espere a recibir una respuesta para cada solicitud antes de enviar la siguiente.

* Tenga en cuenta que el límite de solicitudes está fijado en 15 por segundo. Cuando genere grandes volúmenes, envíe las solicitudes de forma secuencial para evitar superar el límite y recibir un error 429.

* Para obtener la lista de códigos, llame al método Obtener códigos de cupón.

| Parámetro | Valor |
|---|---|
| Número mínimo de códigos por solicitud. | 1 |
| Número máximo de códigos por solicitud. Úselo únicamente cuando necesite el lote más grande posible en una sola operación. | 50 000 |
| Número recomendado de códigos por solicitud. | Hasta 10,000. Si necesita crear más, envíe varias solicitudes consecutivas. |

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 del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto y en la barra de direcciones del navegador cuando se trabaja en un proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `external_id` (integer, required)
    ID externo de la promoción. Identificador único de la promoción dentro del proyecto.
    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"