文档导读

本手册面向零售场景(消费类手机 App)的对接开发者,覆盖账号与个人空间、设备绑定与分享的接口契约、对接流程与覆盖缺口,与机构场景 App 接口文档同一范式。

读者

零售 App 的客户端 / 服务端对接开发者:需要实现注册登录、设备绑定、设备列表渲染、设备分享与账号注销等功能,并为联调失败排查找权威依据。

阅读路径

  1. 接入指南:账号与个人空间概念、HTTP 约定、错误响应差异与验证状态口径。
  2. 接口:账号、个人空间设备、设备分享三个业务域的操作正本与引用页。
  3. App 场景流程:注册登录、绑定、分享、解绑边界与注销五条流程串联正本页。
  4. 覆盖与缺口:在册条目的统计口径、具名缺口与兼容候选。

验证口径

本手册全部结论来自后端源码核验,未联调——没有手机 app 调用图佐证,各正本页均记录核验日期与后端基线 commit。「已源码核验、未联调」不得读作生产验证通过;验证状态纪律见接入指南中的验证状态页。