Skip to main content

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

FieldRequiredTypeRemarkSample
pageNoNointegerPagination page number, 0 represents the first page1
pageSizeNointegerNumber of entries per page, maximum 20010
memberIdYesstringmemberId

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

FieldRequiredTypeRemarkSample
statusYesstringstatus code of the api call
messageYesstringdetail message of the api call
errorCodeNostring
morePageNobooleanWhether has more page. If this value is true, you may want to continue to check next pagetrue
pageNoNointegerPagination page number, 0 represents the first page1
pageSizeNointegerNumber of entries per page, maximum 20010
itemsNoobject[]
. pointCodeYesstringkdp serial numberxx
. pointTimeYesstringpoint time, rfc3339 format2024-09-27T13:43:22+08:00
. pointYesintegerpoint100
. dollarYesstringdollar0.40
. pointTypeYesstringPoint type: Sale、Redeption、Manual、Promotion、Conversion、Expired、PointAsCash、OtherSale
. storeCodeNostring(Reserved field) Store Code
. storeNameEnNostring(Reserved field) Store name (EN)
. storeNameScNostring(Reserved field) Store name (SC)
. storeNameTcNostring(Reserved field) Store name (TC)
. descEnNostringDesc (EN)
. descScNostringDesc (SC)
. descTcNostringDesc (TC)

Response Headers

Error Codes

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