# 获取优惠链列表

获取优惠链列表以用于管理。
注意所有项目的单次响应中返回的商品数量都有上限。默认值和最大值为每次响应10个商品。如需更多数据，可通过limit与offset参数分页获取。

Endpoint: GET /v2/project/{project_id}/admin/offer_chain
Version: 2.0.0
Security: basicAuth

## Path parameters:

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

## Query parameters:

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

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

  - `enabled` (integer)
    通过is_enabled标志筛选元素。

## Response 200 fields (application/json):

  - `has_more` (boolean)
    用作指示还有更多页面。
    Example: true

  - `items` (array)

  - `items.attribute_conditions` (array)
    用户属性验证条件。
根据用户属性是否满足所有指定条件来确定优惠链可用性。

  - `items.date_end` (string,null)
    优惠链结束日期。可为null，若date_end为null则无时间限制。
    Example: "2020-04-15T18:16:00+05:00"

  - `items.date_start` (string)
    优惠链开始日期。
    Example: "2020-04-15T18:16:00+05:00"

  - `items.description` (object,null)
    包含本地化商品描述的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，en）或五个字符的区域设置代码（例如，en-US）。虽然两种格式都可作为输入接受，但响应会返回两个小写字母的语言代码。当为同一种语言提供了两种输入时（例如：en和en-US），将存储最后提供的值。您可以在[文档](/zh/doc/shop-builder/references/supported-languages/)中找到支持语言的完整列表。

  - `items.id` (integer)
    优惠链唯一ID。
    Example: 9

  - `items.is_always_visible` (boolean)
    优惠链是否对所有用户可见：
* 如为true，则无论用户的认证状态或属性如何，优惠链始终显示。
* 如为false，则仅在未找到个性化优惠链时才显示该优惠链。例如，当用户未认证或其属性与任何个性化优惠链都不匹配时。

仅适用于存在个性化奖励链的前提，并在未传递attribute_conditions数组时使用。
    Example: true

  - `items.is_enabled` (boolean)
    Example: true

  - `items.name` (object,null)
    包含商品本地化名称的对象。值接受以下两种格式之一：两个小写字母的语言代码（例如，en）或五个字符的语言代码（例如，en-US）。虽然两种格式都可作为输入接受，但响应会返回两个小写字母的语言代码。当为同一种语言提供了两种输入时（例如：en和en-US），将存储最后提供的值。您可以在[文档](/zh/doc/shop-builder/references/supported-languages/)中找到支持语言的完整列表。

  - `items.order` (integer)
    定义排列顺序。
    Example: 1

  - `items.recurrent_schedule` (object,null)
    重复性优惠链的重置周期。

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401