应用管理后台

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

应用管理后台


PDF版下载

可以为第三方应用设置一个管理后台,对第三方应用做一些必要的管理设置,可以按照如下步骤操作:

设置应用管理后台地址

第三方服务商在应用详情为第三方应用设置“管理后台主页” 图片

企业管理员进入应用后台

图片

管理员点击应用中的“进入管理后台”跳转到第三方服务商的“管理后台主页”链接,点击跳转到管理后台之后,服务商的管理后台可以得到授权码和过期时间,用于获取访问的管理员身份:

获取访问管理员身份

第一步:获取应用提供商凭证

请求方式:POST(HTTPS)

请求地址https://api.im.baidu.com/api/service/get_provider_token

请求body

{
    "corpid": "corpid_value",
    "provider_secret": "provider_secret_value"
}

参数说明

参数类型参数位置是否必须说明
corpidStringRequestBody应用提供商CorpID
provider_secretStringRequestBody在管理后台服务商-服务商信息-开发信息获取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_tokenStringUrl参数授权登录服务商的网站时,使用应用提供商的provider_access_token
授权登录企业的网站时,使用企业管理组的access_token
auth_codeStringRequestBody管理员登录授权产生的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登录管理员的信息
email授权方企业信息
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应用名称
appidappid
auth_info该管理员拥有的通讯录权限