11.3 荣誉勋章发放明细接口

接口URL

{开放平台域名地址}/openApi/open/hxgd/medalDetail/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/medalDetail/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：

字段	类型	中文意描述
userMedalId	Long	颁发数据ID
createTime	String	颁发时间
medalId	Long	勋章ID
medalName	String	勋章名称
num	BigDecimal	勋章奖励数量（福豆奖励数量）
account	String	员工账号
userName	String	员工姓名

返回示例

success:

{
  "code": "0",
  "data": {
    "listObj": [
      {
        "userMedalId": 3000000000410455,
        "createTime": "2026-01-04 12:40:01",
        "medalId": 2208091600006519,
        "medalName": "火眼金睛LV1",
        "num": 1.00,
        "account": "16011491",
        "userName": "测试2"
      }
    ],
    "total": 1,
    "currentPage": 1,
    "itemsPerPage": 10
  },
  "msg": "success",
  "errMsg": null
}

fail:

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