芝麻小客服登录接口的使用攻略与异常处理

小芝麻 • • 客服系统

点此进入芝麻小客服官网


芝麻第三方登陆接口使用说明

说明：使用芝麻客服提供的第三方登陆接口，可以无缝衔接小客服PC端、小程序，实现免密码登陆。

一、登陆的前提条件

使用第三方登陆接口，必须具备的前提条件：

 芝麻小客服登录接口的使用攻略与异常处理

access_token：这个参数是芝麻开放接口中所有接口都需要使用的一个参数，有效的access_token是能调用芝麻开放接口的前提。开发者可以从xxxx.查看相关文档。

scope：第三方登陆密令。密令的获取是通过调用开放接口中的 【登录scope凭证接口】获取。

注意：此接口需注意以下情况：

1、 频率限制：该接口频率限制是指同一登陆客服账户3秒内只能请求获取scope一次。如：芝麻zhima_id（在芝麻后台开放接口查看）为test的第三方，名下有客服A和B两个。获取A的scope时，距离上一次获取A的scope间隔不能小于3s。B的scope获取，跟A无关系。

2、 scope阅后即焚：scope是一次性的，在以下情况会被销毁：

① 、当用户获得scope后，带着scope请求登陆接口后这个scope就被销毁了

② 、获得scope后，一个小时内都没有登陆，那么scope过了有效期也会销毁。

③ 、同一登陆账户请求了新的scope后，上一个scope自动销毁。

二、登陆的流程

1、登陆PC的流程

 芝麻小客服登录接口的使用攻略与异常处理

注：登陆芝麻小客服的pc端，在获取scope时，login_type应填pc。

在获取了scope后，直接带着access_token和scope（post和get都可以）进行跳转，网址格式:

https://xiaokefu.com.cn/zhimaOpen/Staff/staffLogin?access_token=1&scope=2

3、小程序端登陆
 芝麻小客服登录接口的使用攻略与异常处理

三、异常说明

 芝麻小客服登录接口的使用攻略与异常处理

附小程序端跳转Demo:

https://ossxkf.oss-cn-beijing.aliyuncs.com/login_demo.zip

点此进入芝麻小客服官网

您有问题需要咨询的话，可以扫描下方二维码：

 芝麻小客服登录接口的使用攻略与异常处理

原创文章，作者：小芝麻，如若转载，请注明出处：https://xiaokefu.com.cn/blog/22219.html

赞 (0)
小芝麻小芝麻
0
上一篇 1天前
下一篇 1天前

相关推荐