开始开发

获取 AppKey 和 AppSecret

1. 登录乐享知识库，以管理员身份进入企业管理后台， 一键直达 (opens new window)

2. 进入【开发】-【接口凭证管理】，点击添加凭证

3. 弹窗中输入接口凭证名称并确认，初始化成功会显示 AppSecret，切勿泄漏。

给 AppKey 分配接口权限

创建凭证成功后，点击修改权限，勾选当前AKSK允许调用的接口并保存

获取 access_token

access_token 是第三方调用应用接口时的唯一凭证，开发者必须妥善保存

access_token 有效时间为2小时，开发者需要缓存，避免频繁调用获取 access_token 接口导致超出频率限制被拦截

请求URL

POST https://lxapi.lexiangla.com/cgi-bin/token

请求头

参数	是否必须	说明
Content-Type	是	固定值："application/json; charset=utf-8"

其他说明

事项	说明
频率限制	20次/10分钟

请求参数

{
   "grant_type": "client_credentials",
   "app_key": "xxx",
   "app_secret": "xxx"
}

请求参数说明

参数	是否必须	说明
grant_type	是	使用固定值 client_credentials
app_key	是	管理后台获取的 AppKey
app_secret	是	管理后台获取的 AppSecret

响应

• 200 Ok 状态码

{
   "token_type": "Bearer",
   "expires_in": 7200,
   "access_token": "XXXXXXXXX"
}

响应参数说明

参数	说明
token_type	Token 类型
expires_in	凭证有效时间，单位：秒
access_token	凭证

• 400 Bad Request

{
    "errors": {
        "app_key": [
            "app key 是无效的."
        ]
    }
}

• 401 Authorization Required

{
    "errors": {
        "detail": "app_secret错误，请核对"
    }
}

• 429 Too Many Requests

请求超出频率限制

使用 access_token

假设获取到的 access_token 为 xxxxxxxxxxx

HTTP Header 设置格式如下：

Authorization: Bearer xxxxxxxxxxx

调用乐享开放接口时，若access_token无效会返回 401 Unauthorized 错误