获取User Token
最后更新于 2024/10/15   阅读数 405

订阅蜂支持通过获取User Token的方式实现Web免登录

通过以下步骤进行身份验证和Web免登录:

  • 获取租户API KEY

  • 生成令牌USER TOKEN

  • 使用回调URL进行免登录

获取租户API KEY

登录订阅蜂,在个人中心 > 组织信息,点击“获取API Key”,然后复制获取的API Key信息即可。

生成令牌USER TOKEN

POST /v1/oauth/user-token

请求体

{
   "account":"15910861974",
   "apiKey":"db3ecd65addf69f0ae5580d160e2a477",
   "quoteId":"db4ecd89addf69f0ae5580d160e2a852",
   "redirectPage":5 //不填默认跳转工作台;1 工作台;2客户管理;3商机管理;4产品;5报价管理;6报价审批;7报价协同;8-报价列表; 
}
1
2
3
4
5
6
json

注:redirectPage:非必填项,默认为 1

(1 - 工作台; 2 - 客户管理; 3 - 商机管理;4 - 产品; 5- 创建报价;6 - 报价审批; 7 - 报价协同;8-报价列表; 9-报价详情)

响应体 - 5 创建报价

{
    "code": 200,
    "data": {
        "redirectUrl": "https://www.dingyuefeng.cn/thirdPartyLogin?user_token=8bb6b209a3614935976db981c00c23b4&redirect_url=quoteManage?type=create&customerId=&navigationBar=on",
        "userToken": "8bb6b209a3614935976db981c00c23b4"
    },
    "message": "请求成功",
    "success": true
}
1
2
3
4
5
6
7
8
9
json

使用回调URL进行免登录

前端通过将返回的redirectUrl 集成到内部应用中,实现web端免登录

5: 创建报价的URL 及参数

"redirectUrl": "https://www.dingyuefeng.cn/thirdPartyLogin?user_token=8bb6b209a3614935976db981c00c23b4&redirect_url=quoteManage?customerId=&navigationBar=on&createButton=on&queryButton=on"

参数

默认值

是否必填

描述

customerId

null

false

客户id/crmId

quoteName

null

false

报价单名称,模糊匹配

navigationBar

on

false

on/off, 是否显示导航栏

createButton

queryButton

on

false

on/off,是否显示创建/查询按钮

8 :报价列表的URL 及参数

"redirectUrl": "https://www.dingyuefeng.cn/thirdPartyLogin?user_token=8bb6b209a3614935976db981c00c23b4&redirect_url=quoteManage?type=list&customerId=&quoteName=&productName=&navigationBar=on&createButton=on&queryButton=on"

参数

默认值

是否必填

描述

customerId

null

false

客户id/crmId

quoteName

null

false

报价单名称,模糊匹配

productName

null

false

产品名称,模糊匹配(报价里包含了此产品)

navigationBar

on

false

on/off, 是否显示导航栏

createButton/queryButton

on

false

on/off,是否显示创建/查询按钮

本篇目录

获取租户API KEY

生成令牌USER TOKEN

使用回调URL进行免登录