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

  • 一、免密登录

    • 1.1 获取accessToken
      • 1.3 【旧版】根据账号获取临时授权码
      • 1.4 【旧版】授权码登录
      • 1.5 【旧版】客户方小程序免密跳转东福小程序
      • 1.6 免密授权登录(客户方应用内嵌东福H5页面)
      • 1.7 免密授权登录(客户方小程序跳转百福得小程序)
    • 二、组织架构同步

    • 三、积分对接

    • 四、订单

    • 五、小程序现金支付

    • 六、用户资金

    • 七、差旅

    • 八、勋章

    • 九、消息对接

    • 十、客户定制

    • 十一、其它

    • 附录

    • 接口文档
    • 一、免密登录
    2023-09-26
    目录

    1.1 获取accessToken

    # 1.1 获取accessToken

    # 接口说明

    1、根据appId和appSecret获取access_token(接口令牌,调用别的接口都需要此参数),此接口调用次数限制为60次/小时,请注意在本地或者redis中缓存获取到的access_token,避免重复获取达到上限,造成接口调用失败。

    2、access_token的有效期为7200秒,为了考虑兼容性问题,所以请保持缓存时间为7100秒左右,到期请调用手动刷新

    3、需要注意凭证请求Content-Type 为 application/x-www-form-urlencoded 或 URL地址栏传参,当前此接口暂时不支持application/json传参

    # 接口URL

    {开放平台域名地址}/openApi/open/access_token/create

    # HTTP请求方式

    POST

    # 公共参数

    参数名称 参数类型 是否必须 描述
    appId String 是 由百福得向客户方发放
    grant_type String 是 固定字符串为client_credential
    timestamp String 是 毫秒级时间戳,以Java为例,取System.currentTimeMillis()。百福得接口允许的毫秒级时间戳偏差为5分钟,偏差超过5分钟的请求将被拒绝(以服务器为准)。
    sign String 是 签名
    version String 否 业务接口版本号,如1.0.0

    # 请求示例

    POST /openApi/open/access_token/create HTTP/1.1
    Content-Type: application/x-www-form-urlencoded
    
    appId=123456&grant_type=client_credential&sign=27e1f7ase213213ae2bf3672fd9101ba010a2434c119&timestamp=1620710648458
    
    1
    2
    3
    4

    # 返回参数说明

    参数名称 参数类型 描述
    code String 返回码
    msg String 如果错误,返回错误信息。
    data TokenResponse 如果没有错误,返回业务数据

    # TokenResponse

    参数名称 参数类型 描述
    access_token String token访问令牌
    expires_in integer token的有效时长,单位:s(秒)

    # 返回示例

    {
      "code": 0,
      "data": {
        "access_token": "cde2c369fab499c0bf0643bb1844e70c",
        "expires_in": 7200
      },
      "msg": "OK"
    }
    
    1
    2
    3
    4
    5
    6
    7
    8

    ← 开发前必读 1.3 【旧版】根据账号获取临时授权码→

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