开放接口版本 v1

接口与事件合同

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

7正式端点

请求合同

认证头: 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/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

提交待审应用事件。

受控事件写入

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

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