AENET ecosystems PUBLIC GATEWAY
申请试点
GATEWAY READY
EN ไทย 中文
system-detail K.PUBLIC.SYSTEM

SYS.DEV.01 D07 public-api

Public API

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

领域: 开发者平台 状态: active 公共边界: 仅观察 最后更新: 2026-08-16
KAP-GRID K.PUBLIC.SYSTEM.C03

系统 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
  • GET /api/v1/early-access
  • POST /api/v1/early-access/register

连接的系统

安全边界

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

数据方向

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

公共接口

由 API 注册表生成

GET /api/v1/architecture aenet.public.architecture.v1 active 只读
GET /api/v1/development-queue aenet.public.development-queue.v1 active 只读
GET /api/v1/early-access aenet.public.early-access.v1 active 只读
POST /api/v1/early-access/register aenet.public.early-access.registration.v1 active 写入
GET /api/v1/roadmap aenet.public.roadmap.v1 active 只读
GET /api/v1/status aenet.public.status.v1 active 只读
GET /api/v1/time aenet.public.time.v1 active 只读
GET /api/v1/wallet aenet.public.wallet.overview.v1 active 只读
GET /api/v1/wallet/architecture aenet.public.wallet.architecture.v1 active 只读
GET /api/v1/wallet/evidence aenet.public.wallet.evidence.v1 active 只读
GET /api/v1/wallet/security aenet.public.wallet.security.v1 active 只读
GET /public-data/*.json aenet.public.snapshot.* active 只读

安全

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

是什么

以结构化的 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
  • 提供 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 导出经过净化的公开快照。
  • AENET Wallet — 本地优先、只观察（watch-only）的比特币钱包架构，支持外部签名与 Rust 机器集成。它是 AENET 生态系统的私有运行系统；公开侧仅观察经过净化的快照。
  • 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

下一步