腾讯乐享接口文档

# 身份验证

# 构造网页授权链接

https://lexiangla.com/connect/oauth2/authorize?
company_id=COMPANY_ID&suite_id=SUITE_ID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE

# 参数说明：

参数 是否必须 说明
company_id 是 企业唯一标识
suite_id 是 第三方应用唯一标识
redirect_uri 是 授权后重定向的回调链接地址，请使用urlencode对链接进行处理。域名须与应用预设域名一致
response_type 是 返回类型，此时固定为：code
scope 是 应用授权作用域。
snsapi_base：静默授权，可获取成员的的基础信息；
snsapi_userinfo：静默授权，可获取成员的详细信息；
state 否 重定向后会带上state参数，企业可以填写a-zA-Z0-9的参数值，长度不可超过128个字节

腾讯乐享同意授权企业成员访问应用后，页面将跳转至 redirect_uri?code=CODE&state=STATE，第三方应用后台可根据code参数在下面步骤获取访问用户身份。

# 获取访问用户身份

# 接口调用说明：

POST https://lxapi.lexiangla.com/cgi-bin/service/get_user_info?suite_access_token=SUITE_ACCESS_TOKEN

# 请求数据编码格式:

Content-Type: application/json

# 请求参数

{
    "code": "CODE"
}

# 参数说明：

参数 是否必须 说明
suite_access_token 是 第三方应用接口调用凭证
code 是 通过成员授权获取到的code。每次成员授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。

# 接口返回说明：

# scope=snsapi_base时，正常返回：
{
    "data": {
        "staff_id": "STAFF_ID",
        "company_id": "COMPANY_ID"
    },
    "msg": "success",
    "code": 0
}
参数 说明
staff_id 成员所在企业内的唯一身份标识
company_id 企业的唯一身份标识
# 异常返回：
{
    "data": null,
    "msg": "invalid code",
    "code": 40029
}

← 成员管理 →