# 获取代码的促销码限制

获取代码可以使用的剩余次数。要筛选代码，请使用codes查询参数。

要配置代码限制本身，请前往“管理”部分：
 *促销码

Endpoint: GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    项目ID。您可以在您的发布商帐户项目名称旁边找到。
    Example: 44056

  - `external_id` (integer, required)
    促销活动外部ID。项目内的唯一促销活动标识符。
    Example: "coupon_44056_1"

## Query parameters:

  - `codes[]` (array)
    区分大小写的唯一代码。仅包含字母和数字。

  - `limit` (integer)
    页面上元素数量的限制。
    Example: 50

  - `offset` (integer)
    元素编号，从该元素开始生成列表（从0开始数）。

## Response 200 fields (application/json):

  - `has_more` (boolean)
    如果存在其他含代码的页面。

  - `items` (array)

  - `items.code` (string)
    区分大小写的唯一券码。包含字母和数字。
    Example: "WINTER2021"

  - `items.per_code` (object)

  - `items.per_code.available` (integer)
    促销码的剩余可用次数。

  - `items.per_code.reserved` (integer)
    促销码被保留的次数。

  - `items.per_code.total` (integer)
    促销码可以使用的最大次数。

  - `items.per_code.used` (integer)
    促销码被使用的次数。

  - `promotion_id` (integer)
    促销活动ID。项目内的唯一促销活动标识符。

  - `total_items_count` (number)
    代码总数。

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401

## Response 404 fields (application/json):

  - `errorCode` (integer)

  - `errorMessage` (string)

  - `statusCode` (integer)

  - `transactionId` (string)

## Response 422 fields (application/json):

  - `errorCode` (integer)

  - `errorMessage` (string)

  - `errorMessageExtended` (array)

  - `statusCode` (integer)