> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt. # 终端签到与密钥轮换 使用当前终端凭证签到并轮换密钥。签到频率按开通配置确认,勿在每次交易超时后自动签到。 ## 接口信息 - **接口地址:** POST `https://api.aimt-horizon.com/terminal/checkin` - **签名凭证:** 使用当前 `terminal_sn` + `terminal_key` ## 请求参数 | 字段 | 类型 | 要求 | | --------------------------------------- | ------ | ---------------------------- | | `terminal_sn` | String | 必填;与请求头一致。 | | `return_store` / `return_time` | String | 可选;字符串 "1" 分别请求门店信息/服务器毫秒时间。 | | `device_id` / `os_info` / `sdk_version` | String | 可选;按调用方实际设备信息填写。 | ## 请求示例 ```json { "terminal_sn": "2101107140290972547", "return_time": "1" } ``` ## 响应验签与密钥更新 成功响应的 `biz_response.terminal_key` 为新密钥。**此接口是普通响应签名规则的例外:** 成功响应使用这个新密钥签名,而不是请求时的旧密钥。保持 HTTPS 证书校验,读取原始响应字节后解析出新密钥,用它验证该原始响应;校验通过后原子持久化新密钥,后续请求使用新值。失败响应仍按已匹配的请求密钥验证。 :::warning 并发轮换与密钥存储 同一终端避免多个实例并发轮换,防止旧配置覆盖新密钥。服务端存在 next/current/last 过渡匹配,但不承诺旧密钥无限期可用。新密钥不得出现在日志、截图或前端配置中。 :::