应用管理后台
优质
小牛编辑
200浏览
2023-12-01
应用管理后台
可以为第三方应用设置一个管理后台,对第三方应用做一些必要的管理设置,可以按照如下步骤操作:
设置应用管理后台地址
第三方服务商在应用详情为第三方应用设置“管理后台主页”
企业管理员进入应用后台
管理员点击应用中的“进入管理后台”跳转到第三方服务商的“管理后台主页”链接,点击跳转到管理后台之后,服务商的管理后台可以得到授权码和过期时间,用于获取访问的管理员身份:
获取访问管理员身份
第一步:获取应用提供商凭证
请求方式:POST(HTTPS)
请求地址:https://api.im.baidu.com/api/service/get_provider_token
请求body:
{
"corpid": "corpid_value",
"provider_secret": "provider_secret_value"
}
参数说明:
参数 | 类型 | 参数位置 | 是否必须 | 说明 |
---|---|---|---|---|
corpid | String | RequestBody | 是 | 应用提供商CorpID |
provider_secret | String | RequestBody | 是 | 在管理后台服务商-服务商信息-开发信息获取ProviderSecret值 |
返回结果:
{
"provider_access_token": "provider_access_token_value",
"expires_in": 7200
}
参数说明:
参数 | 说明 |
---|---|
provider_access_token | 应用提供商的access_token,可用于用户授权登录信息查询接口 |
expires_in | 有效期 |
第二步:获取访问管理员身份
请求方式:POST(HTTPS)
请求地址:https://api.im.baidu.com/api/service/get_login_info?access_token=ACCESS_TOKEN
请求body:
{
"auth_code": "auth_code_value"
}
参数说明:
参数 | 类型 | 参数位置 | 是否必须 | 说明 |
---|---|---|---|---|
access_token | String | Url参数 | 是 | 授权登录服务商的网站时,使用应用提供商的provider_access_token; 授权登录企业的网站时,使用企业管理组的access_token |
auth_code | String | RequestBody | 是 | 管理员登录授权产生的auth_code |
登录用户为企业运营管理员或外部管理员时返回示例如下:
{
"usertype": 1,
"user_info": {
"email": "example@example.com"
},
"corp_info": {
"corpid": "hi6c698d13f7a409a4"
},
"agent": [
{
"agentid": 0,
"name": "",
"appid": 1
},
{
"agentid": 1,
"name": "",
"appid": 2
},
{
"agentid": 2,
"name": "",
"appid": 3
}
],
"auth_info": {
"department": [
{
"id": "2",
"writable": "false"
}
]
}
}
参数说明:
参数 | 说明 |
---|---|
usertype | 登录用户的类型 1:企业创建人,2:企业内部系统管理员,3:企业外部系统管理员,4:企业分级管理员 |
user_info | 登录管理员的信息 |
授权方企业信息 | |
corpid | 授权方企业CorpID |
agent | 该管理员在该提供商中能使用的应用列表 |
agentid | 应用ID |
name | 应用名称 |
auth_info | 该管理员拥有的通讯录权限 |
登录用户为企业内部管理员时返回示例如下:
{
"usertype": 2,
"user_info": {
"userid": "userid_value",
"name": "username_value",
"email": "example@example.com"
},
"corp_info": {
"corpid": "hi6c698d13f7a409a4"
},
"agent": [
{
"agentid": 0,
"name": "",
"appid": 1
},
{
"agentid": 1,
"name": "",
"appid": 2
},
{
"agentid": 2,
"name": "",
"appid": 3
}
],
"auth_info": {
"department": [
{
"id": "2",
"writable": "true"
}
]
}
}
参数说明:
参数 | 说明 |
---|---|
usertype | 登录用户的类型 1:企业创建人,2:企业内部系统管理员,3:企业外部系统管理员,4:企业分级管理员 |
user_info | 登录管理员的信息 |
userid | 管理员UserID |
name | 管理员姓名 |
corp_info | 授权方企业信息 |
corpid | 授权方企业CorpID |
agent | 该管理员在该提供商中能使用的应用列表 |
agentid | 应用ID |
name | 应用名称 |
appid | appid |
auth_info | 该管理员拥有的通讯录权限 |