接入指南与公共约定#

本栏目给出零售 App 对接的前置概念与公共约定，是阅读后续接口页与流程页的基础。

• 账号与个人空间：用户个人空间租户、设备库存租户（pcm）的边界，设备投影三态（库存 / 直接拥有 / 分享），绑定授权码 V1/V2 两种格式，设备归属转移绑定与设备强制绑定的区别。
• HTTP 约定：AES 加密 JWT Bearer 的携带方式、租户自动注入、权限预期。
• 错误响应差异：认证失败返回 HTTP 200 + status=1000 的响应族，业务失败不能当网络错误处理。
• 验证状态与依据：「已源码核验、未联调（无 app 调用图）」纪律与逐页基线 commit 要求。

接口操作、场景流程与覆盖缺口分别在接口、App 场景流程与覆盖与缺口栏目展开。端点字段级契约（参数、请求/响应字段、错误码）不复述于本手册，唯一权威源是 API 域data-service 端点清单（device 与 user-center 模块），各操作页已带链接。