如果您的应用和站斧开放平台对接时需要获取用户隐私数据(如店铺,用户信息等),为保证用户数据的安全与隐私,您的应用需要取得用户的授权,即获取访问用户数据的授权令牌 access_token 。这种情况下,您的应用需要引导用户完成使用站斧帐号“登录授权”的流程。该流程采用国际通用的OAuth2.0标准协议作为用户身份验证与授权协议)。


1、请求入口地址

1)获取授权码(code)

授权正式环境:https://mms.zhanfubrowser.com/#/open/auth?response_type=code

2)获取访问令牌(access_token)

正式环境:通过rux.open.auth.token.create接口获取access_token


2、授权操作步骤

实际进行授权操作时,以下按流程图逐步说明。


1)拼接授权url拼接用户授权需访问url ,示例及参数说明如下:授权:

https://mms.zhanfubrowser.com/#/open/auth?response_type=code&app_key=****

2)引导用户登录授权引导用户通过浏览器访问以上授权url,将弹出如下授权页面(只有主账号才能授权)。如果主账号已经登录,点“授权并登录”按钮授权即可,如果主账号未登录,点击“授权并登录”按钮即可进入登录页面,输入主账号用户名密码登录成功之后,跳回授权页面,点击“授权并登录”按钮,授权即可。

注意事项:

1)授权应用可直接重复授权



3)获取code若用户点“授权并登录”按钮后,将授权码code 返回到了回调地址上,应用可以获取并使用该code去换取access_token;code有效期10分钟,10分钟后需要重新授权,多次使用code换取access_token是一样的,返回数据展示如下:https://redirect_url/?code=74afa4f59c4048d3aba7a152089e9db87797d6cc


4)换取access_token调用 rux.open.auth.token.create 接口,注意,应用access_token存在有效期,过期后需要重新授权,access_token获取请求如下:

HTMLhttps://gw-open.zhanfubrowser.com/api/route?api=rux.open.auth.token.create&app_key=****&code=yourcode×tamp=1603293524&sign=5A33CB0DDF40D03ECBAB38DBA668B82F


示例:换取access_token返回值

JSON收起{ "errorCode":0, "message":"登录成功", "data":{ "access_token":"ofZ5Pte0achQSHYSaOSWzUVFlSB3OUV1pES9eG2V6Nuclokl", "refresh_token":"hdlbarM3eAtmCWKBl28Gnkq5LBjlqrPI8ntcoZcJbO0zdjSF", "access_expires":10080, "refresh_expires":20160 }}


3.授权时长

授权时长:自授权成功后15天内有效