接入流程
优质
小牛编辑
136浏览
2023-12-01
接入流程
新建应用
登录企业,进入应用中心-新建应用,填写信息创建成功 创建完成后,该应用会自动出现在可见范围内成员的如流应用中心,根据配置的应用地址显示在手机端或电脑端。
应用详情-功能-应用-设置。查看可见范围内成员。
管理组授权应用权限
进入设置-权限设置-系统管理组-新建下级管理组,将应用添加到管理组应用权限中,同时也可以设置管理组的通讯录权限、接口使用权限等。
获取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调用凭证 |