11.1 员工福利申领明细接口

接口URL

{开放平台域名地址}/openApi/open/hxgd/activityApplyDetail/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
updateStartTime	String	是	更新开始时间，格式为yyyy-MM-dd HH:mm:ss
updateEndTime	String	是	更新结束时间，格式为yyyy-MM-dd HH:mm:ss，开始结束时间跨度不能超过7天

请求示例

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

返回参数说明

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

ResponseData：

字段	类型	中文意描述
activityId	Long	福利申领ID
activityName	String	福利申请名称
account	String	员工账号
userName	String	员工姓名
createTime	String	申请时间，格式为yyyy-MM-dd HH:mm:ss
applyAmount	BigDecimal	申请额度（福豆）
applyFormList	List<CareActivityApplyFormDTO>	申请信息表单

CareActivityApplyFormDTO：

字段	类型	中文意描述
optionsName	String	选项
optionsValue	String	选项值

返回示例

success:

{
  "code": "0",
  "data": {
    "listObj": [
      {
        "activityId": 2503251200022083,
        "activityName": "行为积分申请【测试GZ】",
        "account": "388990",
        "userName": "测试",
        "createTime": "2025-06-23 16:17:31",
        "applyAmount": 5.00,
        "applyFormList": [
          {
            "optionsName": "姓名",
            "optionsValue": "【测试】"
          },
          {
            "optionsName": "所属部门",
            "optionsValue": "员工体验部"
          },
          {
            "optionsName": "行为项",
            "optionsValue": "改变自己"
          }
        ]
      }
    ],
    "total": 1,
    "currentPage": 1,
    "itemsPerPage": 10
  },
  "msg": "success",
  "errMsg": null
}

fail:

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