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

  • 一、免密登录

  • 二、组织架构同步

    • 2.1 部门同步(主动查询)
      • 2.2 部门同步(客户推送)
      • 2.3 用户同步(主动查询)
      • 2.4 用户同步(客户推送)
      • 2.5 查询用户推送批次结果
      • 2.6 企微、钉钉、飞书平台对接
    • 三、积分对接

    • 四、订单

    • 五、小程序现金支付

    • 六、用户资金

    • 七、差旅

    • 八、勋章

    • 九、消息对接

    • 十、客户定制

    • 十一、其它

    • 附录

    • 接口文档
    • 二、组织架构同步
    2023-09-26
    目录

    2.1 部门同步(主动查询)

    # 2.1 部门同步(主动查询)

    企业方面提供查询接口,百福得主动查询,全量更新部门信息(分页查询)

    # 接口URL

    客户方提供,百福得主动查询

    # HTTP请求方式

    POST

    # 公共参数

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

    # body参数

    字段 类型 是否必填 中文意描述
    pageNo Integer 是 页码
    pageSize Integer 是 单页数量 默认200

    # 请求示例

    POST /deplist?appId=abc&timestamp=1620710648458&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
    Content-Type: application/json
    Cache-Control: no-cache
    {
    	"pageNo":1,
    	"pageSize":200
     }
    
    1
    2
    3
    4
    5
    6
    7

    # 返回参数说明

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

    ResponseData:

    字段 类型 是否必填 中文意描述
    name String 是 部门名称
    code String 是 部门编码(唯一)
    parentCode String 否 父级部门编码(无则为顶级部门)

    # 返回示例

    success:

    {
      "code": "0",
      "msg": "success",
      "data": [
        {
          "name": "技术部",
          "code": "TL001",
          "parentCode": "001"
        },
        {
          "name": "财务中心",
          "code": "CA002",
          "parentCode": "001"
        }
      ]
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16

    fail:

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

    ← 1.7 免密授权登录(客户方小程序跳转百福得小程序) 2.2 部门同步(客户推送)→

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