账户查询方法

中继 RPC 协议 · 方法公共约定

device.status

device.status 向账户当前归属中继查询指定设备的当前授权状态，主要用于其他中继建立设备会话前的授权检查。已经由源中继设备会话授权的业务请求，不为同一次操作重复调用本方法。

请求参数

响应对象

处理与缓存规则

目标中继只能根据本地保存的当前 AccountDeviceState 回答查询；其他中继的缓存不得作为权威结果。只有当前状态存在与设备 ID 匹配、双重签名有效且当前时间位于证书有效期的最新证书时，才返回 active；其他情况统一返回 inactive，不区分从未存在、已移除、尚未生效或已经到期。

调用方必须确认认证对端是该账户的当前归属中继，并按响应关联规则将结果与原请求关联。

调用中继可以按本地有限缓存策略使用已验证结果；缓存必须保持请求账户、设备与认证对端的绑定，不能作为其他账户、设备或归属中继的查询结果。缓存超过该有限窗口时必须失效；active 结果的缓存到达其 expires_at 时也必须失效。一旦获知更新状态，必须停止使用旧缓存。

调用方可以用同一设备 ID 的旧证书验证历史或在途对象中的设备公钥绑定和签名；当前权限只取决于该设备 ID 在最新权威状态中是否仍是有效设备，不要求旧证书与最新证书的完整内容相同。

device.state.resolve

device.state.resolve 用于取得目标账户当前完整设备状态，供调用方选择当前有效的接收设备并生成密钥盒。

请求参数

本方法接受两种请求参数：

• 公开查询：params 必须显式包含目标 account，字段定义见客户端—中继 device.state.resolve 的按账户读取；不携带请求证书、请求签名或访问凭据。
• 签名查询：使用客户端—中继 device.state.resolve 的完整签名请求，其中 account 指定目标账户；源中继不得重建、删减或改写字段。

查询形式的识别与完整性校验遵循客户端—中继 device.state.resolve 的WebSocket 查询规则。自身读取只在客户端与归属中继之间使用，不适用于本方法。

响应对象

响应对象及调用方验证要求均遵循客户端—中继 device.state.resolve 的响应规则。

处理与错误

源中继接受客户端请求时，必须确认设备会话仍然有效。

公开查询

公开查询的目标中继必须确认当前资料已开启公开发现，否则返回 forbidden。目标中继不验证客户端会话，也不查询请求设备状态。仅携带账户 ID 的中继间请求始终按公开查询授权，不适用客户端通过归属中继设备会话获得的自身读取权限。

签名查询

签名查询时，源中继还必须确认请求证书对应本次调用设备及调用账户，并验证请求证书和请求签名。该检查是本次读取对请求设备的授权判定；设备状态在此后发生变化，不追溯已经接受的本次请求。目标中继必须重新验证签名设备证书、请求签名和账户绑定。请求签名使用该证书的 signing_public_key 验证。目标中继不重复查询或判定请求设备的当前状态。

签名查询时，目标中继按客户端—中继 device.state.resolve 的规定验证访问凭据。

错误与路由处理

业务校验和 created_at 新鲜度检查的错误，遵循客户端—中继 device.state.resolve 的处理规则；源中继按客户端所用传输方式的错误映射规则，将目标中继的错误返回给客户端。账户路由变化遵循账户路由规则，其他错误遵循错误响应规则。

profile.resolve

profile.resolve 用于取得指定账户当前有效的 AccountProfile。

请求参数

请求参数是客户端—中继 profile.resolve 的完整请求参数，其中 account 指定目标账户。

响应对象

响应对象及调用方验证要求均遵循客户端—中继 profile.resolve 的响应规则。

处理与错误

源中继接受客户端请求时，必须确认设备会话仍然有效。目标中继不验证客户端会话、不查询请求设备状态，也不验证联系人授权。

目标归属校验、参数错误、资料不存在和响应验证均遵循客户端—中继 profile.resolve 的处理规则；源中继按客户端所用传输方式的错误映射规则，将目标中继的错误返回给客户端。账户路由变化遵循账户路由规则，其他错误遵循错误响应规则。