#开始开发
# 开始开发 # 获取 AppKey 和 AppSecret 以腾讯乐享管理员身份进入管理页 找到开发-接口凭证,点击获取接口凭证(没找到?) 此时会弹出二维码需...
# 开始开发 # 获取 AppKey 和 AppSecret 以腾讯乐享管理员身份进入管理页
找到开发-接口凭证,点击获取接口凭证(没找到?)
此时会弹出二维码需要当前用户扫码登录确认管理员身份,扫码登录后,确定获取
初始化成功会显示 AppSecret,请用户复制后妥善保存,切勿泄漏。关闭弹框后不再显示 AppSecret
此时可从页面上看到 AppKey,在下一步获取 access_token 中会用到
# 获取 access_token access_token 是第三方调用应用接口时的唯一凭证,开发者必须妥善保存。
access_token 目前有效时间为2小时,开发者需要缓存,避免频繁调用获取 access_token 接口导致超出频率限制被拦截。
# 接口调用说明: POST https://lxapi.lexiangla.com/cgi-bin/token
# 参数说明: 参数 是否必须 说明 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 状态码 参数错误,如 app_key 不存在,缺少必填参数,grant_type 错误等
# 429 Too Many Requests 状态码 请求超出频率限制
# 使用 access_token 调用任何一个接口时,请求都必须带上 access_token。
设置方式有2种,假设获取到的 access_token 为 xxxxxxxxxxx
方式1:HTTP Header 设置格式如下:
Authorization: Bearer xxxxxxxxxxx
方式2:url上直接带上 ?access_token=xxxxxxxxxxx
在请求应用接口时必须用有效的 access_token,否则会返回 401 Unauthorized 错误。
# 设置 x-staff-id 此设置仅适用于应用接口和内容上传接口
一般写操作的应用接口都需要以某个员工的身份去请求,这个信息需在 HTTP Header 中设置。
x-staff-id: LX001