开放接口版本 v1

接口与事件合同

认证、作用域、配额和响应元数据在所有受保护端点保持一致；世界日期与真实服务器时间明确分栏。

12正式端点

请求合同

认证头: Authorization: Bearer <key>
响应版本: meta.apiVersion = v1
配额字段: quotaRemaining / quotaResetAt
日期语义: 任务字段使用架空世界日期；服务器生成和配额字段使用真实 UTC。

端点与作用域

GET/api/developer/v1/institutions/institutions.read

国家机构公开目录。

GET/api/developer/v1/content/content.read

已发布内容摘要；兼容窗口内继续提供。

GET/api/developer/v1/content-records/content.read

已发布内容记录的现行 operation。

GET/api/developer/v1/places/places.read

版本化地域、层级、别名与公开状态目录。

GET/api/developer/v1/datasets/datasets.read

数据目录与质量元数据。

GET/api/developer/v1/infrastructure/infrastructure.read

交通、能源、供水与邮政公开网络和状态。

GET/api/developer/v1/space/space.read

航天任务、发射和延迟遥测。

POST/api/developer/v1/events/events.write

提交待审应用事件。

GET/api/developer/v1/lifecycle/lifecycle.read

读取当前客户端合同、通知、影响和迁移状态。

POST/api/developer/v1/lifecycle/acknowledgements/lifecycle.write

确认当前客户端收到的确切通知修订。

POST/api/developer/v1/lifecycle/migrations/lifecycle.write

提交当前客户端迁移证据。

GET/api/developer/v1/interoperability/interoperability.read

读取当前客户端的互操作 binding 与交换回执。

受控事件写入

{
  "idempotencyKey": "client-run-001",
  "eventType": "application.signal.submitted",
  "subjectType": "APPLICATION",
  "subjectId": "linhe-event",
  "command": "submit-result",
  "payload": { "result": "resolved" }
}

成功提交只产生 PENDING 世界事件；审核通过前不会生成公开事实或修改门户内容。