芝麻第三方登陆接口使用说明 说明:使用芝麻客服提供的第三方登陆接口,可以无缝衔接小客服PC端、小程序,实现免密码登陆。 ## 一、登陆的前提条件 使用第三方登陆接口,必须具备的前提条件: ![](https://img.kancloud.cn/ed/9f/ed9fe4ecf3be875eb4806a7e4587c66b_505x246.png) **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的流程 ![](https://img.kancloud.cn/f8/8e/f88e190f45fab802d282c6fcf8590bf6_554x416.png) 注:登陆芝麻小客服的pc端,在获取scope时,login\_type应填pc。 在获取了scope后,直接带着access\_token和scope(post和get都可以)进行跳转,网址格式: **https://xiaokefu.com.cn/zhimaOpen/Staff/staffLogin?access\_token=1&scope=2** <br/> 3、小程序端登陆 ![](https://img.kancloud.cn/1c/a2/1ca20dc8ee896dab0169ba6dfcb3f4a3_554x540.png) ## 三、异常说明 | 错误码| 说明| 原因| | --- | --- | --- | | 1003| access\_token解析错误| access_token过期;zhima_id和zhima_secret不匹配;旧的access_token| | 1| 您无权限登陆此客服xxx| 没有相关的权限| | 1| 您请求的太快了,请稍后重试| 登陆同一客服请求频率间隔小于3s| <br/> ## 附小程序端跳转Demo: **https://ossxkf.oss-cn-beijing.aliyuncs.com/login_demo.zip**