AENET.cloud PUBLIC GATEWAY
K.PUBLIC.GATEWAY
ENไทย中文
system-detail K.PUBLIC.SYSTEM

public-api

Public API

AENET Cloud Public 的只读公共 API v1。提供公共状态、时间、架构、开发队列、路线图和抢先体验，且表面严格受限。

状态: active 最后更新: 2026-08-16

系统 ID

public-api

状态

active

架构层级

  • L2 公共应用（路由器）
  • L4 公共服务（API）

输入

  • 公共数据快照与服务（状态、时间、架构、队列、路线图、抢先体验）

输出

  • 带一致信封的 JSON 响应；抢先体验注册票据（D1）

公共接口

  • GET /api/v1/status
  • GET /api/v1/time
  • GET /api/v1/architecture
  • GET /api/v1/development-queue
  • GET /api/v1/roadmap
  • POST /api/v1/early-access/register

连接的系统

安全边界

只读且受限。预览与私有路由返回 403。无认证，除抢先体验注册路径外无写入通道，无核心访问。

数据方向

公共快照 → API 响应（读取）。抢先体验注册 → D1（唯一写入路径，绝不进入核心）。

是什么

以结构化的 JSON 契约公开公共安全、只读的数据，同时让所有私有路由无法触及。

为什么

访客和开发者需要机器可读的公共数据，但绝不能有任何通往私有或内部系统的路径。Public API 通过 v1 契约、信封和禁用/私有路由控制解决。

如何

公共快照 → API 响应（读取）。抢先体验注册 → D1（唯一写入路径，绝不进入核心）。

  • 提供 GET /api/v1/status
  • 提供 GET /api/v1/time
  • 提供 GET /api/v1/architecture
  • 提供 GET /api/v1/development-queue
  • 提供 GET /api/v1/roadmap
  • 提供 GET /api/v1/early-access/register（POST 注册）
  • 以 403 拒绝预览/私有路由
  • 强制一致的 API 信封

示例

开发者调用 GET /api/v1/time 并收到带版本的封套 {ok, schema, requestId, issuedAt, data}——只读、无认证、无核心访问。

输入

  • 公共数据快照与服务（状态、时间、架构、队列、路线图、抢先体验）

输出

  • 带一致信封的 JSON 响应；抢先体验注册票据（D1）

依赖

public-snapshot-layerpublic-timeearly-accessaenet-cloud-public

生命周期

  • v1 契约
  • 信封
  • 路由控制
  • openapi.public.json 文档

使用场景

  • 开发者阅读公共 API 契约与示例
  • 访客通过 API 查看公共状态与时间
  • 用户注册抢先体验

限制

  • 设计上只读——除抢先体验外没有写 API
  • 不签发 API 密钥（keyIssuanceDisabled）
  • 预览路由被有意禁用
  • 内部模式与私有路由绝不发布

连接的系统

  • AENET Cloud Public — AENET 生态系统的对公入口与观察层。它只发布经过净化的快照、静态页面、公共 API 和匿名流量通道——仅此而已。
  • AENET Core — AENET 私有生态系统。它永远不公开路由，只能通过快照契约向 aenet-cloud-public 导出经过净化的公开快照。
  • Development Queue — AENET 系统正在建设什么的公开视图——一个状态机（DISCOVERED → SPECIFIED → BUILDING → VERIFYING → PREVIEW → RELEASED），没有虚假的进度百分比。
  • Early Access — 测试 AENET 公共网关的公开等待名单。申请人记录仅存于 D1，绝不索引、导出或发布；没有 Turnstile 验证时注册默认失败关闭。
  • KAP Language — 本仓库广泛使用的一种声明式契约风格，用机器可读的 .kap 文件描述公开站点、导航、内容、布局、动效、时间、流量与抢先体验。
  • Public Snapshot Layer — 从 public-data/ 发布经过净化、预生成的 JSON 快照（站点、状态、架构、文章、路线图、队列、拓扑、流量摘要）的层级。
  • Public Time — AENET Cloud Public 的公共时间服务。它以明确的质量提供规范 UTC，并且在未经验证的原子源之前绝不声称原子验证。

相关研究

  • The AENET Public Entrance — What this public entrance is, what the public may observe, and where the one-way boundary sits.

人们常问的问题

这些问题由本页内容解答。

  • 什么是 AENET Public API？
  • 有哪些公共端点可用？
  • 当前使用哪个 API 版本？
  • AENET API 是只读的吗？
  • 抢先体验 API 如何工作？

证据

仅已验证状态——本页内容均非预测。

  • api/public-api-contract.json
  • contracts/openapi.public.json
  • server/routes/api-v1.js
  • docs/PUBLIC_API.md

下一步