#开始开发

# 开始开发 # 获取 AppKey 和 AppSecret 登录乐享知识库，以管理员身份进入企业管理后台， 一键直达 (opens new window)

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

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

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

# 给 AppKey 设置知识授权范围 默认选择公司内所有知识。若指定团队，团队管理、知识库管理、自定义属性管理、AI助手等接口可读写的实体范围都将受限制

# 获取 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 错误