For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/api/checkin.md.
  • 简体中文
  • 终端签到与密钥轮换

    使用当前终端凭证签到并轮换密钥。签到频率按开通配置确认,勿在每次交易超时后自动签到。

    接口信息

    • 接口地址: POST https://api.aimt-horizon.com/terminal/checkin
    • 签名凭证: 使用当前 terminal_sn + terminal_key

    请求参数

    字段类型要求
    terminal_snString必填;与请求头一致。
    return_store / return_timeString可选;字符串 "1" 分别请求门店信息/服务器毫秒时间。
    device_id / os_info / sdk_versionString可选;按调用方实际设备信息填写。

    请求示例

    {
      "terminal_sn": "2101107140290972547",
      "return_time": "1"
    }

    响应验签与密钥更新

    成功响应的 biz_response.terminal_key 为新密钥。此接口是普通响应签名规则的例外: 成功响应使用这个新密钥签名,而不是请求时的旧密钥。保持 HTTPS 证书校验,读取原始响应字节后解析出新密钥,用它验证该原始响应;校验通过后原子持久化新密钥,后续请求使用新值。失败响应仍按已匹配的请求密钥验证。

    并发轮换与密钥存储

    同一终端避免多个实例并发轮换,防止旧配置覆盖新密钥。服务端存在 next/current/last 过渡匹配,但不承诺旧密钥无限期可用。新密钥不得出现在日志、截图或前端配置中。