Skip to content

获取令牌

功能介绍


本文档介绍了如何获取和使用鹰眼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

参数名类型必填说明
usernamestring账户名称,获取此信息可在管理后台查看
passwordstring账户密码,获取此信息可在管理后台查看

返回结果

json
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "token_type": "Bearer",
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJsb2dpblR5cGUiOiJsb2dpbiIsImxvZ2luSWQiOiJzeXNfdXNlcjoyIiwicm5TdHIiOiJrSWJCZjRZMUJ3RGxiNVJHMTZlSlVlalF1UDFhZUgwaiIsInVzZXJJZCI6Mn0.qJ1GYZ7BCQwbwKVKAbq7NIIPzWD7l6lZGc_HCCAXew0",
    "expires_in": 86400
  }
}

返回参数说明

参数类型含义
token_typestring凭证类型(默认Bearer)
access_tokenstring获取到的凭证
expires_innumber凭证的有效时间(秒)

接口调试