心跳守护

在用户登录后，需要定期调用心跳守护接口，用于保持会话的活跃状态，防止会话过期，使用心跳守护，是为了让服务器更好的了解当前登录设备的数量， 防止单个卡密被重复登录等。

注意

登录后，如果长时间（10分钟）没有调用心跳守护接口，可能会导致会话过期，需要重新登录。

请求地址

https://api.keyikami.com/v1/tick

请求参数

参数名	类型	必填	说明
secretId	string	是	密钥id
secretKey	string	是	密钥key
sessionToken	string	是	会话令牌
key	string	是	会话密钥

注意

• sessionToken是登录接口返回的sessionToken
• key是登录接口或心跳守护接口返回的nextKey
• key 每次心跳守护接口都需要更新
• 如果会话过期，sessionToken 和 key 需要重新从登录接口获取

请求示例

import requests

secretId = "你的密钥id"
secretKey = "你的密钥key"
sessionToken = "登录接口返回的会话令牌"
key = "登录或心跳接口返回的会话密钥"
url = "https://api.keyikami.com/v1/tick"

response = requests.post(url, json={
    "secretId": secretId,
    "secretKey": secretKey,
    "sessionToken": sessionToken,
    "key": key
})

print(response.json())

返回参数

参数名	类型	说明
code	int	状态码
nextKey	string	下一个会话密钥

注意

nextKey 是下一个会话密钥，下一次心跳守护接口或者登出接口需要使用。

返回示例

调用成功后，返回的 json 示例数据如下：

{
  "code": 0,
  "nextKey": "fdaf45rHFGDSOadffd" // 每次返回的都不一样
}