Xsolla-logoXsolla Developers
ou
Conta de Distribuidor

Obter limite de código promocional para códigosServer-sideAdmin

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

Obtém o número restante de vezes que os códigos podem ser usados. Para filtrar os códigos, use o parâmetro de consulta codes.

Para configurar o limite de código em si, vá para a seção Admin:

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Example: 44056
external_id
required
integer

ID externo de promoção. Identificador exclusivo da promoção dentro do projeto.

Example: coupon_44056_1
query Parameters
codes[]
Array of strings

Códigos exclusivos que diferenciam maiúsculas de minúsculas. Contém apenas letras e números.

limit
integer

Limite da quantidade de elementos na página.

Example: limit=50
offset
integer

Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0).

Example: offset=0
Responses
200

Limites de código promocional recebidos com sucesso para um código.

401

Autenticação básica não aprovada ou errada. Verifique se você usou a autenticação básica ou as credenciais corretas.

404

Item não encontrado.

422

Solicitação invá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/promocode/external_id/{external_id}?codes%5B%5D=string&limit=50&offset=0'
Response samples
application/json
{
  • "has_more": false,
  • "items": [
    ],
  • "promotion_id": 1,
  • "total_items_count": 2
}