纷享销客开发者手册 纷享销客开发者手册
  • APL开发手册
  • PWC开发手册
  • OpenAPI 文档
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门

  • API授权流程

    • OAuth授权认证

      • 客户端凭证模式
      • 授权码模式
      • 刷新令牌
    • API基础说明

    • OpenAPI

    • 免登集成方案

    • 客户端开发

    • 常见问题

    目录

    刷新 accessToken

    access_token 是调用授权关系接口的调用凭证,由于 access_token 有效期较短,当 accessToken 超时后,可以使用 refreshToken 进行刷新。

    refresh_token 拥有较长的有效期(2 个月),当 refresh_token 失效后,需要用户重新授权。

    # 请求说明

    请求方式:POST + application/json

    请求路径:https://${填入所在云的域名}/oauth2.0/token?thirdTraceId=${随机字符串}

    # 请求参数

    参数 参数类型 必须 说明
    grantType String 是 授权模式,固定值为:refresh_token
    appId String 是 自建应用的 appId
    appSecret String 是 自建应用的 appSecret
    refreshToken String 是 获取 token 接口返回的 refreshToken

    # 请求示例

    {
        "grantType": "refresh_token",
        "appId": "FSAID_xxxxx",
        "appSecret": "982axxxxx",
        "refreshToken": "xxxxxx"
    }
    

    # 返回参数

    参数 必须 说明
    openUserId 是 用户的 openUserId
    accessToken 是 授权凭证 token,有效期两个小时
    refreshToken 是 用于刷新 accessToken,有效期两个月
    expiresIn 是 过期时间

    # 返回示例

    {
        "openUserId": "FSUID_xxxxx",
        "accessToken": "FSTOK_xxxxx",
        "refreshToken": "FSREFTOK_xxxxx",
        "expiresIn": 7200,
        "errorCode": 0,
        "errorMessage": "success",
        "traceId": "E-O.fkxxxxxx8bd6"
    }
    
    授权码模式
    测试工具

    ← 授权码模式 测试工具 →

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