---
title: "pointRedemptionRule"
description: "分页查询店铺内生效中的积分兑换规则列表。"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20260901
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/queries/point-redemption-rule'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/queries/point-redemption-rule.md'
---
# pointRedemptionRule

分页查询店铺内生效中的积分兑换规则列表。

- **API Version:** v20260901
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Query

## Arguments

* `after`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  返回指定游标之后的元素。如果指定了该参数，也必须要指定 `first` 参数。

* `before`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  返回指定游标之前的元素。如果指定了该参数，也必须要指定 `last` 参数。

* `first`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md)

  返回列表中的前 n 个元素。

* `last`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md)

  返回列表中的最后 n 个元素。

* `reverse`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  是否反转列表的顺序。
  
  ● true：反转
  
  ● false：不反转
  
  默认值：false

* `channel`

  [PointRuleChannel](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/enums/point-rule-channel.md)

  积分兑换规则适用的渠道。如果该参数不传，默认查询 `ONLINE_STORE` 渠道的规则。

## Returns

* `edges`

  [[CustomerPointsRedemptionRuleInfoEdge!]!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/customer-points-redemption-rule-info-edge.md)

  边对象列表，包含节点及其对应的游标。

* `pageInfo`

  [PageInfo!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/page-info.md)

  当前页的分页信息。

* `nodes`

  [[PointsRedemptionRule]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/member-system/objects/points-redemption-rule.md)

  节点的扁平化列表。

## Examples

### 查询积分兑换规则列表

查询积分兑换规则列表

**Request:**

```json
query {
    pointRedemptionRule(first:1) {
		edges{      
			cursor     
			node{           
				id  
				name  
				customisedDescription     
				icon    
				allowRevokeRedemption  
				point {
					cashbackPoint 
					cashbackAmount 
					couponCodePoint 
					couponCodePercentage  
					couponPoint 
					couponAmount 
					freeShippingPoint 
					freeProductPoint 
					freeProductId } 
				pointsAutoDeduct
				disablePointsRefund  
				ruleType
				cashbackbenefitsUsageThreshold{
					minPurchaseAmountEnabled
					minPurchaseAmount
					minPointsEnabled
					minPoints
					maxPointsEnabled
					maxPoints
					maxDeductAmountEnabled
					maxDeductAmount }  
				benefitRedemptionCondition{
					benefitRedemptionConditionType
					minPurchaseAmountValue
					minItemQuantityValue }  
				couponUsageScope
				productsApplicableType
				autoStackLimit
				codeStackLimit
				channel
				allowRevokeRedemption
				specificCategoryIds
				expiryRule
				specificProductIds
				redemptionLimit{
					type
					period
					count}   
				}
			}
			pageInfo{
				hasNextPage
				hasPreviousPage
				endCursor
				startCursor}
			}
		}

```

**Response:**

```json
{
  "data": {
    "data": {
      "pointRedemptionRule": {
        "edges": [
          {
            "cursor": "4C04ED4B4B70D849A6EDE3DF4AFAD2872B0AB19E47EF82F37DC4C3F337AD1FC6",
            "node": {
              "id": "gid://shopline/Membership/PRI*************552879",
              "pointsAutoDeduct": null,
              "productsApplicableType": "ALL",
              "redemptionLimit": {
                "count": 5,
                "period": 30,
                "type": "LIMITED"
              },
              "specificProductIds": [],
              "benefitRedemptionCondition": null,
              "codeStackLimit": true,
              "expiryRule": 30,
              "icon": "https://img.myshopline.com/image/member/*********4596/**********************2595c901ad.png?w=846&h=372",
              "name": "free",
              "point": {
                "freeProductId": "gid://shopline/Product/******************51381124",
                "freeShippingPoint": null,
                "cashbackAmount": null,
                "cashbackPoint": null,
                "couponAmount": null,
                "couponCodePoint": null,
                "freeProductPoint": 11,
                "couponCodePercentage": null,
                "couponPoint": null
              },
              "ruleType": "FREE_PRODUCT",
              "specificCategoryIds": [],
              "allowRevokeRedemption": false,
              "autoStackLimit": true,
              "cashbackbenefitsUsageThreshold": {
                "maxPointsEnabled": false,
                "minPoints": null,
                "minPointsEnabled": false,
                "minPurchaseAmount": null,
                "minPurchaseAmountEnabled": false,
                "maxDeductAmount": null,
                "maxDeductAmountEnabled": false,
                "maxPoints": null
              },
              "channel": "ONLINE_STORE",
              "couponUsageScope": "FOR_ALL",
              "customisedDescription": "desc",
              "disablePointsRefund": null
            }
          }
        ],
        "pageInfo": {
          "endCursor": "4C04ED4B4B70D849A6EDE3DF4AFAD2872B0AB19E47EF82F37DC4C3F337AD1FC6",
          "hasNextPage": true,
          "hasPreviousPage": false,
          "startCursor": "4C04ED4B4B70D849A6EDE3DF4AFAD2872B0AB19E47EF82F37DC4C3F337AD1FC6"
        }
      }
    },
    "extensions": {
      "cost": {
        "throttleStatus": {
          "maximumAvailable": 100000,
          "restoreRate": 100000,
          "currentlyAvailable": 99989
        },
        "actualQueryCost": 11,
        "requestedQueryCost": 11
      }
    }
  }
}
```

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes)。