Obtener límites de código único de cupón

Xsolla Developers

Obtener límites de código único de cupónServer-sideAdmin

get/v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}

Obtiene el número restante de veces que se pueden utilizar los códigos. Para filtrar los códigos, utilice el parámetro de consulta codes.

Para configurar el límite de códigos propiamente dicho, vaya a Admin:

Coupons.

SecuritybasicAuth

Request

path Parameters

project_id required	integer ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto. Example: 44056
external_id required	integer ID externo de la promoción. Identificador único de la promoción dentro del proyecto. Example: coupon_44056_1

query Parameters

codes[]	Array of strings Códigos únicos que distinguen mayúsculas de minúsculas. Solo contienen letras y números.
limit	integer Límite para el número de elementos presentes en la página. Example: limit=50
offset	integer Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0). Example: offset=0

Responses

200

Se recibieron correctamente los límites del cupón para un código.

401

Autenticación básica no superada o errónea. Asegúrese de haber utilizado la autenticación básica o las credenciales correctas.

404

Artículo no encontrado.

422

Solicitud no válida.

Request samples

curl -i -X GET \
  -u <merchant_id_or_project_id>:<api_key> \
  'https://store.xsolla.com/api/v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}?codes%5B%5D=string&limit=50&offset=0'

Response samples

application/json

{"has_more": false,
"items": [{"code": "WINTER2023",
"per_code": {"available": 7,
"reserved": 1,
"total": 10,
"used": 2
}
},
{"code": "SUMMER2023",
"per_code": {"available": 0,
"reserved": 2,
"total": 5,
"used": 3
}
}
],
"promotion_id": 1,
"total_items_count": 2
}