数字居民及可用范围
合同范围 / 来源目录、选择计划与异步准备
已有本地基础 · 对外候选
在批准的数据来源、地区和字段范围内选择居民，再冻结合法起点。可用性、覆盖与缺失必须如实表达；选择条件不能创造居民或补造资格。
01 / API 能力
一套连接方式，
明确的能力范围。
以下基于已有合同与候选文档。已实现的本地基础、候选接口和未来规划分别表述，均不代表正式公开发布。
场景与条件输入
合同范围 / 结构化商品信息与场景定义
有限场景合同 · 候选
当前自然观测主流程以结构化商品信息为基础。保存场景不等于居民已看到；任意政策、天气、收入事件不因自然语言描述就自动受支持。
独立世界线
合同范围 / 冻结选择、快照与世界线绑定
已有隔离基础 · 对外候选
沿合同绑定冻结选择与版本，保留各条世界线的独立经历。场景变化不回写原始底片，也不改变其他世界线。
异步任务与居民决策
合同范围 / 准备任务、有限观测运行与许可
候选链路 · 正式服务待验收
异步准备和有限观测分别处理受理、进度、许可与完成。获得 API 授权不等于每次执行均获许可；居民可能拒绝或没有反应。
结果观察与读取
合同范围 / 观察、覆盖与用量读取
候选读取合同 · 覆盖待核验
按固定读取修订与游标获取结果，保留样本、来源和限制。读取不推进运行；UNKNOWN、失败和待处理不能解释为零反应。
更复杂的事件输入、完整长期观察与比较工具仍需独立完善和验收，不由上述候选链路推定已经支持。
02 / 未来接入流程
从理解能力，
到读取真实的模型结果。
这是未来标准接入的概念流程。当前没有公开注册、Token 申请或正式调用服务入口。
- 01
了解能力
核对数据范围、场景输入和结果限制，判断是否适合你的产品。
- 02
申请授权
未来按正式流程提交申请，经审批确认来源与可用范围。
- 03
接入 API
在正式文档、服务地址与凭据交付可用后开展集成。
- 04
提交任务
按合同提交有限任务，处理许可、幂等与异步状态。
- 05
获取结果
读取已完成的结果及覆盖，保留来源与未知，不补造反馈。
03 / 接入前需要了解
把重要的规则，
放在开始之前。
只概述现有合同与已确认产品原则，不替代正式版本文档，也不表示生产服务或收费已启用。
身份认证与 API Key
业务 API 使用 Bearer Key；控制台登录 Cookie 不是 API Key。服务端核对来源、批准范围与资源权限，账户注册本身不授予 API 使用权。
尚无公开凭据申请入口。
请求与响应
字段及版本应来自合同指定的实际返回，不能自行猜测。响应以版本、请求标识、状态、认证范围与数据表达；请求标识用于排查问题。
正式参数与格式以发布后的版本文档为准。
异步执行与任务状态
HTTP 202 只表示已受理，不表示任务已完成。准备、运行及许可状态需要分别读取；普通 GET 读取不会隐式推进任务或居民时间。
待处理、失败与完成必须分别处理。
幂等与错误恢复
响应丢失时保留原 Idempotency-Key 与原请求内容，先核对原任务或收据。不能靠换键、重复提交或重新创建身份绕过未知状态。
恢复依现有证据，不把重试当新任务。
计费与额度
已确认产品原则为每条独立、完成、持久化、可追溯的有效居民决策 ¥0.05；同一决策的多项反馈不拆费，幂等重试与历史读取不重复收决策费。
这是产品原则，非正式收费已启用。余额、合法权限与技术额度分别约束；测试 NON_CASH 不等于正式付款。
数据来源与结果限制
数据许可、可用范围、时间覆盖及模型推断需可追溯。数字居民不是现实真人，模型反馈不等于真人调研；数字交易不等于现实成交。
结果不保证现实经营收益或预测精度。
04 / API 文档
正式文档，
随正式服务一同开放。
候选文档用于整理合同、示例来源与待核事项，不等于正式公开 API。最终支持范围、版本与地址需要按发布配置核验。
文档入口尚未开放
- 公开文档地址
- 待确认
- 正式服务地址
- 待确认
当前不提供在线调用、Key 输入或凭据申请。
05 / 开发者支持