11.2 夸夸卡收发明细接口

接口URL

{开放平台域名地址}/openApi/open/hxgd/thankCardDetail/list 注：本接口为T+1查询接口，非特殊情况只允许查询近30天内的数据，且每次分页最多返回200条数据，创建开始时间与创建结束时间跨度不能超过7天，如首次对接需全量拉取数据，请联系百福得进行配置。

HTTP请求方式

POST

公共参数

字段	类型	是否必填	中文意描述
appId	String	是	由百福得向客户方发放
timestamp	String	是	毫秒级时间戳 防止重复攻击
sign	String	是	签名
version	String	否	业务接口版本号，如1.0.0

body参数

字段	类型	是否必填	中文意描述
currentPage	Integer	否	页码，默认1
itemsPerPage	Integer	否	页数，默认10，分页数量不能超过200
createStartTime	String	是	创建开始时间，格式为yyyy-MM-dd HH:mm:ss
createEndTime	String	是	创建结束时间，格式为yyyy-MM-dd HH:mm:ss，开始结束时间跨度不能超过7天

请求示例

POST /openApi/open/hxgd/thankCardDetail/list?appId=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
{
	"currentPage": 1,
	"itemsPerPage": 200,
	"createStartTime": "2025-01-01 00:00:00",
	"createEndTime": "2025-01-01 23:59:59"
}

返回参数说明

字段	类型	是否必填	中文意描述
code	String	返回码
data	ResponseData	否	相应报文
msg	String	否	如果错误，返回错误信息

ResponseData：

字段	类型	中文意描述
userThankCardId	Long	发送数据ID
thankCardCode	String	夸夸卡编号
thankCardName	String	夸夸卡名称
sendUserAccount	String	发送人员工账号
sendUserName	String	发送人员工姓名
receiveUserAccount	String	接收人员工账号
receiveUserName	String	接收人员工姓名
userThankCardAmt	BigDecimal	发送金额
createTime	String	发送时间，格式为yyyy-MM-dd HH:mm:ss

返回示例

success:

{
  "code": "0",
  "data": {
    "listObj": [
      {
        "userThankCardId": 2601041500069592,
        "thankCardCode": "DF_611063621S10",
        "thankCardName": "天使卡",
        "sendUserAccount": "95876",
        "sendUserName": "测试1",
        "receiveUserAccount": "35238",
        "receiveUserName": "测试2",
        "userThankCardAmt": 5.00,
        "createTime": "2026-01-04 15:58:13"
      },
      {
        "userThankCardId": 2512051800243373,
        "thankCardCode": "DF_562963621S17",
        "thankCardName": "自驱担当",
        "sendUserAccount": "470287",
        "sendUserName": "测试3",
        "receiveUserAccount": "35238",
        "receiveUserName": "测试4",
        "userThankCardAmt": 5.00,
        "createTime": "2026-01-04 15:58:13"
      }
    ],
    "total": 2,
    "currentPage": 1,
    "itemsPerPage": 10
  },
  "msg": "success",
  "errMsg": null
}

fail:

{
  "code": "10016",
  "msg": "签名错误"
}