百福得开放平台 百福得开放平台
  • H5输出
  • 供应链输出
  • 三方供应商接入
  • H5输出
  • 供应链输出
  • 三方供应商接入
  • 开发指南

  • 一、免密登录

  • 二、组织架构同步

  • 三、积分对接

  • 四、订单

  • 五、小程序现金支付

  • 六、用户资金

  • 七、差旅

  • 八、勋章

    • 8.1 分页查询企业勋章列表
      • 8.2 查询企业勋章详情
      • 8.3 员工勋章发放
      • 8.4 查询勋章发放批次结果
      • 8.5 分页查询勋章发放批次明细
    • 九、消息对接

    • 十、客户定制

    • 十一、其它

    • 附录

    • 接口文档
    • 八、勋章
    2023-09-26
    目录

    8.1 分页查询企业勋章列表

    # 8.1 分页查询企业勋章列表

    # 接口URL

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

    # HTTP请求方式

    POST

    # 公共参数

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

    # body参数

    字段 类型 是否必填 中文意描述
    currentPage Integer 否 页码,默认1
    itemsPerPage Integer 否 页数,默认10
    name String 否 勋章名称
    status Integer 否 状态,0:停用,1:启用

    # 请求示例

    POST /openApi/open/medal/list?appId=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
    Content-Type: application/json
    Cache-Control: no-cache
    {
    	"currentPage": 1,
    	"itemsPerPage": 10,
    	"name": "优秀员工",
    	"status": 1
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9

    # 返回参数说明

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

    ResponseData:

    字段 类型 中文意描述
    id Long 勋章Id
    darkPic String 未点亮勋章图片url
    lightPic String 点亮勋章图片url
    medalClassifyId Integer 勋章分类id
    medalClassifyName String 勋章分类名称
    medalDesc String 勋章描述
    medalSort Integer 勋章排序
    medalType Integer 勋章类型:1独立勋章
    name String 勋章名称
    status Integer 状态,0:停用,1:启用

    # 返回示例

    success:

    {
      "code": "0",
      "data": [
        {
          "id": 221,
          "darkPic": "",
          "lightPic": "",
          "medalClassifyId": 0,
          "medalClassifyName": "NEW_STAFF",
          "medalDesc": "",
          "medalSort": 0,
          "medalType": 1,
          "name": "",
          "status": 0
        },{
          "id": 222,
          "darkPic": "",
          "lightPic": "",
          "medalClassifyId": 0,
          "medalClassifyName": "NEW_STAFF",
          "medalDesc": "",
          "medalSort": 0,
          "medalType": 1,
          "name": "",
          "status": 0
        }
      ],
      "msg": "success"
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29

    fail:

    {
      "code": "10016",
      "msg": "签名错误"
    }
    
    1
    2
    3
    4

    ← 7.2 差旅行程核销关闭 8.2 查询企业勋章详情→

    Theme by Vdoing
    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式