Obtenha limites de código de cupom exclusivos

Xsolla Developers

Conta de Distribuidor

Obtenha limites de código de cupom exclusivosServer-sideAdmin

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

Gets the remaining number of times codes can be used. For filtering the codes, use the codes query parameter.

For configuring the code limit itself, go to the Admin section:

Coupons

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 cupom 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/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
}