接入流程

优质
小牛编辑
136浏览
2023-12-01

接入流程


流程图

PDF版下载

新建应用

登录企业,进入应用中心-新建应用,填写信息创建成功 创建完成后,该应用会自动出现在可见范围内成员的如流应用中心,根据配置的应用地址显示在手机端或电脑端。

图片

应用详情-功能-应用-设置。查看可见范围内成员。

图片

图片

管理组授权应用权限

进入设置-权限设置-系统管理组-新建下级管理组,将应用添加到管理组应用权限中,同时也可以设置管理组的通讯录权限、接口使用权限等。

图片

获取API调用凭证

所有的接口需使用HTTPS协议、JSON数据格式、UTF8编码,调用接口时需携带AccessToken。

调用频次限制

每个企业调用单个接口的频率不可超过800次/秒; 身份验证接口的“/oauth2/authorize”和“/api/user/getuserinfo”不受上述频率限制。

AccessToken

AccessToken是接口使用的全局唯一票据,使用管理组的CorpID和Secret获取; 使用某个管理组Secret获取的AccessToken所拥有的权限和此管理组权限相同; 正常情况下AccessToken有效期为7200秒,有效期内重复获取返回相同结果;

获取AccessToken

请求方式GET(HTTPS)

请求地址https://qy.im.baidu.com/api/gettoken?corpid=CORPID&corpsecret=SECRECT

参数说明

参数是否必须说明
corpid企业ID,在管理后台-设置-基本信息-账户信息-CorpID
corpsecret管理组的凭证密钥,在管理后台-设置-权限设置-管理组名称-开发者凭据-Secret

图片

权限说明

不同的管理组拥有不同的Secret。

返回结果

正确的Json返回结果:

{
   "access_token": "accesstoken000000000888888"
}

错误的Json返回示例:

{
   "errcode": 40001,
   "errmsg": "请求参数错误"
}

返回参数说明

返回参数key说明
access_token获取到的API调用凭证