pointsHistory

query
接口访问需要令牌，具体如何获取令牌参考：身份认证。
查询单个客户的积分流水明细，包括积分的数值增减、变更场景、内部备注和给客户的留言等。
Arguments
after ● String
返回指定游标之后的元素。如果指定了该参数，也必须要指定 first 参数。
before ● String
返回指定游标之前的元素。如果指定了该参数，也必须要指定 last 参数。
first ● Int
返回列表中的前 n 个元素。
last ● Int
返回列表中的最后 n 个元素。
reverse ● Boolean
是否反转列表的顺序。
● true：反转
● false：不反转
默认值：false
customerId ● String!non-null
客户 ID。
Return
edges ● [HistoryOfPointsEdge!]!non-null
边列表。每个边包含节点及对应的游标。
More
pageInfo ● PageInfo!non-null
分页信息。
More
nodes ● [HistoryOfPoints]
积分流水列表。
More
错误码
关于更多通用错误码说明，参考：状态码和错误码。
Example
查询单个客户的积分流水明细
query {
  pointsHistory(customerId: "gid://shopline/Customer/4602226680",first:200) {
    edges{
      cursor
      node{
        notesCustomers
        remarksInternal
        updateScene
        updatedValue
        updatedAt
        expiredAt
        historyRecordId
        updateType
      }
    }
    pageInfo{
      hasNextPage
      hasPreviousPage
      endCursor
      startCursor
    }
    nodes{
        notesCustomers
        remarksInternal
        updateScene
        updatedValue
        updatedAt
        expiredAt
        historyRecordId
        updateType
    }
  }
}
Response
{
	"data": {
		"pointsHistory": {
			"edges": [
				{
					"cursor": "B9B0A75F6AACB745534E8E1B670D480CD799B9A69C03313E5F2466EB506C8D6D",
					"node": {
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-18T07:50:19.289Z",
						"updatedValue": "999",
						"expiredAt": "2099-12-31T15:59:59.000Z",
						"historyRecordId": "PFL6559235588338484853",
						"notesCustomers": null,
						"remarksInternal": null
					}
				},
				{
					"cursor": "50419ECF8B9DCE233E49A0AEE0F7C4AAC0F8E95C62643BE295DCF4AEA3BE189E",
					"node": {
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-18T09:23:45.861Z",
						"updatedValue": "1",
						"expiredAt": "2025-07-18T15:59:59.000Z",
						"historyRecordId": "PFL6559329651030237239",
						"notesCustomers": null,
						"remarksInternal": null
					}
				},
				{
					"cursor": "CDB95FC1FEE44934D741A171B833137EB2CBAB7AA311C34B84C8171EEFF38975",
					"node": {
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-23T02:41:53.246Z",
						"updatedValue": "1",
						"expiredAt": "2025-07-23T15:59:59.000Z",
						"historyRecordId": "PFL6566172865792069221",
						"notesCustomers": null
					}
				},
				{
					"cursor": "ABEEFA5149AC16426C0E85B006A0A19CF0CA2A8C69992561DE5A1F11625C35F5",
					"node": {
						"updatedValue": "1",
						"expiredAt": "2025-07-24T15:59:59.000Z",
						"historyRecordId": "PFL6567975912658708032",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-24T08:33:03.214Z"
					}
				},
				{
					"cursor": "13E5DFC4E44278741403BBCA3CB8A1476C65A864B92EEC725D5D0E40E1F84201",
					"node": {
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-24T08:53:27.041Z",
						"updatedValue": "1102",
						"expiredAt": "2024-12-06T15:59:59.000Z",
						"historyRecordId": "PFL6567996445068633703",
						"notesCustomers": "Increase by 100 points"
					}
				},
				{
					"cursor": "026AF78ED91D8F70F1DDE734606A4C87EB236A09BCC5693907F95830FD3CAD77",
					"node": {
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-26T01:43:14.185Z",
						"updatedValue": "1",
						"expiredAt": "2025-07-26T15:59:59.000Z",
						"historyRecordId": "PFL6570462480065634306",
						"notesCustomers": null
					}
				},
				{
					"cursor": "C784A8E275D7FC74C923BC1958C104B158C1B774A999A0671F32EA1DEB0610CF",
					"node": {
						"expiredAt": "2025-09-20T15:59:59.000Z",
						"historyRecordId": "PFL6651683372719940666",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-09-20T02:28:56.636Z",
						"updatedValue": "1"
					}
				},
				{
					"cursor": "AED80BE69B778D9EA8F39306CFDDBC98EEB9CFC2C602F582E2F0DB45691C2730",
					"node": {
						"updateType": "INCREASE",
						"updatedAt": "2024-10-11T08:45:44.920Z",
						"updatedValue": "100",
						"expiredAt": "2024-12-06T15:59:59.000Z",
						"historyRecordId": "PFL6682503257494408246",
						"notesCustomers": "Increase by 100 points",
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE"
					}
				},
				{
					"cursor": "FF6C1CF75CDD05F2424FC2D8DD80CBDBDCAD0E22C26D4E488E9B6C9504FA2A3B",
					"node": {
						"updatedValue": "1",
						"expiredAt": "2026-01-18T15:59:59.000Z",
						"historyRecordId": "PFL6825060606255046937",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2025-01-17T17:03:45.053Z"
					}
				},
				{
					"cursor": "E1213DF68A1F623D9DE269DCC4A5A3C7B96EA939E96A390BA3783BB379832A71",
					"node": {
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-01-17T17:03:45.357Z",
						"updatedValue": "1202",
						"expiredAt": null,
						"historyRecordId": "PFL6825060611355320604",
						"notesCustomers": null
					}
				},
				{
					"cursor": "362CBEE0C44AE4AC95470CA52CA93EBBF80F3EADABB0BA40B1CF189A19ED138A",
					"node": {
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2025-01-23T17:04:57.759Z",
						"updatedValue": "1",
						"expiredAt": "2026-01-24T15:59:59.000Z",
						"historyRecordId": "PFL6833759134833715055"
					}
				},
				{
					"cursor": "6F99A44220C90A49CE18F59585DEB05A34A5879856B88F1CB021D4AD8166548D",
					"node": {
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-07-19T21:00:08.016Z",
						"updatedValue": "1",
						"expiredAt": null,
						"historyRecordId": "PFL7090566524806112654",
						"notesCustomers": null,
						"remarksInternal": null
					}
				},
				{
					"cursor": "864EC53373B6B62068A46E2CFAB82C02C23F395640AE718BC6C3055268978C70",
					"node": {
						"historyRecordId": "PFL7096364853515263652",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-07-23T21:00:15.337Z",
						"updatedValue": "1",
						"expiredAt": null
					}
				},
				{
					"cursor": "09F46E6FEA2B1B39A44E11330FD92032A2F13E2E4F459ABED1F8C1DF35F971A4",
					"node": {
						"expiredAt": null,
						"historyRecordId": "PFL7099263913272288848",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-07-25T21:00:12.765Z",
						"updatedValue": "1"
					}
				},
				{
					"cursor": "8A9FDE83A452D103DAA318EA0C2CF0425811CC98D79A10AF8C7118B99D3F6E21",
					"node": {
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-07-26T21:00:04.049Z",
						"updatedValue": "1",
						"expiredAt": null,
						"historyRecordId": "PFL7100713318504474574",
						"notesCustomers": null
					}
				},
				{
					"cursor": "5F8301D656EB5A5276C9E8E5A7DA06DB99BF5237488F7805EE272CAD505D9C22",
					"node": {
						"expiredAt": "2099-12-31T15:59:59.000Z",
						"historyRecordId": "PFL7180086253933044745",
						"notesCustomers": "Increase by 100 points",
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2025-09-19T15:09:59.670Z",
						"updatedValue": "100"
					}
				},
				{
					"cursor": "9074853FD45E902F02B9D17712FCBAF1CC7526CA293C137D36E434A22025357F",
					"node": {
						"updateType": "DECREASE",
						"updatedAt": "2025-09-19T15:11:10.860Z",
						"updatedValue": "1102",
						"expiredAt": null,
						"historyRecordId": "PFL7180087448303051787",
						"notesCustomers": "Expected to deduct to 0",
						"remarksInternal": "test node",
						"updateScene": "MANUALLY_DECREASE"
					}
				},
				{
					"cursor": "B9048DD4FB68BE1FA2FECD3A419D2AE670F177044D6C210484A719A9F0B81EDC",
					"node": {
						"updatedValue": "100",
						"expiredAt": "2099-12-31T15:59:59.000Z",
						"historyRecordId": "PFL7180087938952733709",
						"notesCustomers": "Increase by 100 points",
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2025-09-19T15:11:40.106Z"
					}
				},
				{
					"cursor": "E2B212507877194751047C1E7A4056D706C11A8F8396453964E992BD09CC4E11",
					"node": {
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-09-26T14:23:02.101Z",
						"updatedValue": "0",
						"expiredAt": null,
						"historyRecordId": "PFL7190185843206136856",
						"notesCustomers": null
					}
				},
				{
					"cursor": "C20C1F46C3CD81EF06642ABB04D838E44F6CB9040D08481EE9E6290C0A618FE7",
					"node": {
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2025-09-26T14:23:09.821Z",
						"updatedValue": "100",
						"expiredAt": "2099-12-31T15:59:59.000Z",
						"historyRecordId": "PFL7190185972726244359",
						"notesCustomers": "Increase by 100 points"
					}
				}
			],
			"nodes": [
				{
					"historyRecordId": "PFL6559235588338484853",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-18T07:50:19.289Z",
					"updatedValue": "999",
					"expiredAt": "2099-12-31T15:59:59.000Z"
				},
				{
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-18T09:23:45.861Z",
					"updatedValue": "1",
					"expiredAt": "2025-07-18T15:59:59.000Z",
					"historyRecordId": "PFL6559329651030237239",
					"notesCustomers": null,
					"remarksInternal": null
				},
				{
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-23T02:41:53.246Z",
					"updatedValue": "1",
					"expiredAt": "2025-07-23T15:59:59.000Z",
					"historyRecordId": "PFL6566172865792069221",
					"notesCustomers": null
				},
				{
					"expiredAt": "2025-07-24T15:59:59.000Z",
					"historyRecordId": "PFL6567975912658708032",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-24T08:33:03.214Z",
					"updatedValue": "1"
				},
				{
					"updatedAt": "2024-07-24T08:53:27.041Z",
					"updatedValue": "1102",
					"expiredAt": "2024-12-06T15:59:59.000Z",
					"historyRecordId": "PFL6567996445068633703",
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE"
				},
				{
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-26T01:43:14.185Z",
					"updatedValue": "1",
					"expiredAt": "2025-07-26T15:59:59.000Z",
					"historyRecordId": "PFL6570462480065634306",
					"notesCustomers": null
				},
				{
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-09-20T02:28:56.636Z",
					"updatedValue": "1",
					"expiredAt": "2025-09-20T15:59:59.000Z",
					"historyRecordId": "PFL6651683372719940666",
					"notesCustomers": null
				},
				{
					"updatedValue": "100",
					"expiredAt": "2024-12-06T15:59:59.000Z",
					"historyRecordId": "PFL6682503257494408246",
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2024-10-11T08:45:44.920Z"
				},
				{
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2025-01-17T17:03:45.053Z",
					"updatedValue": "1",
					"expiredAt": "2026-01-18T15:59:59.000Z",
					"historyRecordId": "PFL6825060606255046937"
				},
				{
					"expiredAt": null,
					"historyRecordId": "PFL6825060611355320604",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-01-17T17:03:45.357Z",
					"updatedValue": "1202"
				},
				{
					"historyRecordId": "PFL6833759134833715055",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2025-01-23T17:04:57.759Z",
					"updatedValue": "1",
					"expiredAt": "2026-01-24T15:59:59.000Z"
				},
				{
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-07-19T21:00:08.016Z",
					"updatedValue": "1",
					"expiredAt": null,
					"historyRecordId": "PFL7090566524806112654",
					"notesCustomers": null,
					"remarksInternal": null
				},
				{
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-07-23T21:00:15.337Z",
					"updatedValue": "1",
					"expiredAt": null,
					"historyRecordId": "PFL7096364853515263652",
					"notesCustomers": null
				},
				{
					"updatedValue": "1",
					"expiredAt": null,
					"historyRecordId": "PFL7099263913272288848",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-07-25T21:00:12.765Z"
				},
				{
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-07-26T21:00:04.049Z",
					"updatedValue": "1",
					"expiredAt": null,
					"historyRecordId": "PFL7100713318504474574",
					"notesCustomers": null,
					"remarksInternal": null
				},
				{
					"updateType": "INCREASE",
					"updatedAt": "2025-09-19T15:09:59.670Z",
					"updatedValue": "100",
					"expiredAt": "2099-12-31T15:59:59.000Z",
					"historyRecordId": "PFL7180086253933044745",
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE"
				},
				{
					"updatedValue": "1102",
					"expiredAt": null,
					"historyRecordId": "PFL7180087448303051787",
					"notesCustomers": "Expected to deduct to 0",
					"remarksInternal": "test node",
					"updateScene": "MANUALLY_DECREASE",
					"updateType": "DECREASE",
					"updatedAt": "2025-09-19T15:11:10.860Z"
				},
				{
					"updateType": "INCREASE",
					"updatedAt": "2025-09-19T15:11:40.106Z",
					"updatedValue": "100",
					"expiredAt": "2099-12-31T15:59:59.000Z",
					"historyRecordId": "PFL7180087938952733709",
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE"
				},
				{
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-09-26T14:23:02.101Z",
					"updatedValue": "0",
					"expiredAt": null,
					"historyRecordId": "PFL7190185843206136856",
					"notesCustomers": null
				},
				{
					"updatedValue": "100",
					"expiredAt": "2099-12-31T15:59:59.000Z",
					"historyRecordId": "PFL7190185972726244359",
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2025-09-26T14:23:09.821Z"
				}
			],
			"pageInfo": {
				"endCursor": "C20C1F46C3CD81EF06642ABB04D838E44F6CB9040D08481EE9E6290C0A618FE7",
				"hasNextPage": true,
				"hasPreviousPage": false,
				"startCursor": "B9B0A75F6AACB745534E8E1B670D480CD799B9A69C03313E5F2466EB506C8D6D"
			}
		}
	}
}
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2026 SHOPLINE Limited.