外观
获取令牌
功能介绍
本文档介绍了如何获取和使用鹰眼API的登录凭证(access_token)
access_token是调用鹰眼所有API接口和嵌入式H5页面的必要凭证,用于验证开发者的身份和权限。通过本文档提供的接口,开发者可以获取有效的access_token,并在后续的API调用中使用。
使用方法
开发者需要通过HTTP POST请求获取access_token,请求时需要提供账户名称(username)和账户密码(password)两个参数。获取到的access_token有效期为24小时(86400秒),开发者需要在过期前重新获取,以确保API调用的连续性。建议实现access_token的缓存和自动刷新机制,避免频繁请求影响性能。
适用场景
- API接口调用:所有鹰眼API接口调用都需要使用access_token进行身份验证
- H5页面嵌入:在APP、Web或小程序中嵌入鹰眼H5页面时需要提供access_token
- 第三方应用集成:第三方应用与鹰眼平台集成时的身份认证
- 企业应用开发:企业内部应用开发时的用户身份验证和权限管理
access_token是鹰眼API的唯一凭证,用于验证调用者的身份。无论是调用API接口还是嵌入式H5页面,都需要使用access_token。因此,开发者需要妥善保存这个凭证,并定期更新,以防止它失效。
调用接口
请求方式: POST(HTTPS)
请求地址: https://eagleinsight.cn/api/access_token
请求参数
json
{
"username": "账户名称",
"password": "账户密码"
}请求参数说明
Body 参数(application/json)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| username | string | 是 | 账户名称,获取此信息可在管理后台查看 |
| password | string | 是 | 账户密码,获取此信息可在管理后台查看 |
返回结果
json
{
"code": 200,
"msg": "操作成功",
"data": {
"token_type": "Bearer",
"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJsb2dpblR5cGUiOiJsb2dpbiIsImxvZ2luSWQiOiJzeXNfdXNlcjoyIiwicm5TdHIiOiJrSWJCZjRZMUJ3RGxiNVJHMTZlSlVlalF1UDFhZUgwaiIsInVzZXJJZCI6Mn0.qJ1GYZ7BCQwbwKVKAbq7NIIPzWD7l6lZGc_HCCAXew0",
"expires_in": 86400
}
}返回参数说明
| 参数 | 类型 | 含义 |
|---|---|---|
| token_type | string | 凭证类型(默认Bearer) |
| access_token | string | 获取到的凭证 |
| expires_in | number | 凭证的有效时间(秒) |