8.2 查询企业勋章详情

接口URL

{开放平台域名地址}/openApi/open/medal/detail

HTTP请求方式

POST

公共参数

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

body参数

字段	类型	是否必填	中文意描述
medalIds	List<Long>	是	勋章id列表

请求示例

POST /openApi/open/medal/detail?appId=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
{
    "medalIds":[
        1,
        2,
        3
    ]
}

返回参数说明

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

ResponseData：

字段	类型	中文意描述
id	Long	勋章id
darkPic	String	未点亮勋章图片url
isShow	Integer	是否展示，0不展示；1展示
lightPic	String	点亮勋章图片url
medalClassifyId	Integer	勋章分类id
medalCode	String	勋章编码--用于应用勋章库
medalDesc	String	勋章描述
medalDescLan2	String	勋章描述第二语言
medalType	Integer	勋章类型1.独立勋章
name	String	勋章名称
nameLan2	String	勋章名称第二语言
showType	Integer	勋章展示类型1员工始终可见(没获得也可见),2获得后可见
sort	Integer	排序
status	Integer	状态，0：停用,1：启用

返回示例

success:

{
  "code": "0",
  "data": [
    {
      "id": 1,
      "darkPic": "",
      "isShow": 0,
      "lightPic": "",
      "medalClassifyId": 0,
      "medalCode": "",
      "medalDesc": "",
      "medalDescLan2": "",
      "medalType": 0,
      "name": "",
      "nameLan2": "",
      "showType": 0,
      "sort": 0,
      "status": 0
    },
      {
      "id": 2,
      "darkPic": "",
      "isShow": 0,
      "lightPic": "",
      "medalClassifyId": 0,
      "medalCode": "",
      "medalDesc": "",
      "medalDescLan2": "",
      "medalType": 0,
      "name": "",
      "nameLan2": "",
      "showType": 0,
      "sort": 0,
      "status": 0
    }
  ],
  "msg": "success"
}

fail:

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