PointHistory-KDP

Function

Get KDP Point History

Endpoint

• /v1/point/kdp-list

HTTP Method

• POST

Request Headers

• Authorization: Bearer {token}
• X-App-Key: {appKey}

Request Payload

{
  "pageNo": 1,
  "pageSize": 10,
  "memberId": "KT00000001"
}

Request Parameters

Field	Required	Type	Remark	Sample
pageNo	No	integer	Pagination page number, 0 represents the first page	1
pageSize	No	integer	Number of entries per page, maximum 200	10
memberId	Yes	string	memberId

Response Payload

{
  "status": 1,
  "errorCode": 0,
  "message": "success",
  "morePage": true,
  "pageNo": 1,
  "pageSize": 10,
  "items": [
    {
      "pointCode": "1688457253732929112",
      "pointTime": "2023-07-04T15:54:14+08:00",
      "point": "5000",
      "dollar": "20.00",
      "pointType": "Manual",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Points Adjustment",
      "descSc": "积分调整",
      "descTc": "積分調整"
    },
    {
      "pointCode": "1688457253732929112",
      "pointTime": "2023-07-04T15:54:14+08:00",
      "point": "-5000",
      "dollar": "-20.00",
      "pointType": "Manual",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Points Adjustment",
      "descSc": "积分调整",
      "descTc": "積分調整"
    },
    {
      "pointCode": "1688452445130662620",
      "pointTime": "2023-07-04T14:34:05+08:00",
      "point": "4000",
      "dollar": "16.00",
      "pointType": "Promotion",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Promotion",
      "descSc": "推广活动",
      "descTc": "推廣活動"
    },
    {
      "pointCode": "1688452442277037377",
      "pointTime": "2023-07-04T14:34:02+08:00",
      "point": "3000",
      "dollar": "12.00",
      "pointType": "Manual",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Points Adjustment",
      "descSc": "积分调整",
      "descTc": "積分調整"
    },
    {
      "pointCode": "1688452439703383029",
      "pointTime": "2023-07-04T14:33:59+08:00",
      "point": "2000",
      "dollar": "8.00",
      "pointType": "Conversion",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Points Conversion",
      "descSc": "积分转换",
      "descTc": "積分轉換"
    },
    {
      "pointCode": "1688452436637080302",
      "pointTime": "2023-07-04T14:33:56+08:00",
      "point": "1000",
      "dollar": "4.00",
      "pointType": "Sale",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Points Registration",
      "descSc": "登记积分",
      "descTc": "登記積分"
    },
    {
      "pointCode": "1684996066456741068",
      "pointTime": "2023-05-25T14:27:46+08:00",
      "point": "-1000",
      "dollar": "-4.00",
      "pointType": "Manual",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Points Adjustment",
      "descSc": "积分调整",
      "descTc": "積分調整"
    },
    {
      "pointCode": "1684996062295016078",
      "pointTime": "2023-05-25T14:27:42+08:00",
      "point": "-100",
      "dollar": "-0.40",
      "pointType": "Redeption",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Redemption",
      "descSc": "礼品兑换",
      "descTc": "禮品兌換"
    },
    {
      "pointCode": "1684996060103060792",
      "pointTime": "2023-05-25T14:27:40+08:00",
      "point": "-100",
      "dollar": "-0.40",
      "pointType": "PointAsCash",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Spend K Dollars",
      "descSc": "使用K Dollar",
      "descTc": "使用K Dollar"
    },
    {
      "pointCode": "1684996053227224780",
      "pointTime": "2023-05-25T14:27:33+08:00",
      "point": "-200",
      "dollar": "-0.80",
      "pointType": "Redeption",
      "storeCode": "",
      "storeNameEn": "",
      "storeNameSc": "",
      "storeNameTc": "",
      "descEn": "Redemption",
      "descSc": "礼品兑换",
      "descTc": "禮品兌換"
    }
  ]
}

Response Parameters

Field	Required	Type	Remark	Sample
status	Yes	string	status code of the api call
message	Yes	string	detail message of the api call
errorCode	No	string
morePage	No	boolean	Whether has more page. If this value is true, you may want to continue to check next page	true
pageNo	No	integer	Pagination page number, 0 represents the first page	1
pageSize	No	integer	Number of entries per page, maximum 200	10
items	No	object[]
. pointCode	Yes	string	kdp serial number	xx
. pointTime	Yes	string	point time, rfc3339 format	2024-09-27T13:43:22+08:00
. point	Yes	integer	point	100
. dollar	Yes	string	dollar	0.40
. pointType	Yes	string	Point type: Sale、Redeption、Manual、Promotion、Conversion、Expired、PointAsCash、Other	Sale
. storeCode	No	string	(Reserved field) Store Code
. storeNameEn	No	string	(Reserved field) Store name (EN)
. storeNameSc	No	string	(Reserved field) Store name (SC)
. storeNameTc	No	string	(Reserved field) Store name (TC)
. descEn	No	string	Desc (EN)
. descSc	No	string	Desc (SC)
. descTc	No	string	Desc (TC)

Response Headers

Error Codes

Status Code	Status Description
1	Internal Error
3	Missing Parameter
4	Invalid Input
4100	Member not found
4120	Member not bound to KDP