AENET ecosystems 公共网关
在 AENET 上销售 · 抢先体验
GATEWAY READY
ENไทย中文
KAP-GRID / Y C01
公共表面可用

K.PUBLIC.API / D.LAYOUT.CONTROL

AENET 公共 API

只读公共 API v1：开放读取、可选匿名密钥、签名响应、端点注册表与错误目录。

暂停签发新的 API 密钥 — 服务准备期间暂不签发新密钥。公开读取无需密钥。现有密钥仍遵守原有有效期、配额及撤销规则，响应签名不变。恢复签发须经过版本就绪审批。

版本v1
基础路径/api/v1
访问方式开放 · 密钥可选
签名响应ed25519

公共契约

端点注册表

端点26
只读23
写入路径3
开放22
D01REQUEST D02KEY OPTIONAL D03ROUTE D04SNAPSHOT D05ENVELOPE D06CACHE D07SIGNED D08EVIDENCE

S1

快速开始

四条调用覆盖完整流程。读取无需密钥；密钥提供可撤销的配额。

  1. 01

    无需密钥直接调用

    所有标记为 Open 的 GET 端点均可匿名访问，返回 JSON 信封。

    curl "$ORIGIN/api/v1/status"
  2. 02

    暂停签发新的 API 密钥

    服务准备期间暂不签发新密钥。公开读取无需密钥。现有密钥仍遵守原有有效期、配额及撤销规则，响应签名不变。恢复签发须经过版本就绪审批。

    
curl -H "Authorization: Bearer $AENET_KEY" "$ORIGIN/api/v1/status"
  3. 03

    验证签名

    每个 JSON 响应均有 Ed25519 签名。请通过独立渠道固定密钥 ID。

    node scripts/api-verify-response.js \
  "$ORIGIN/api/v1/status" --kid <pinned key id>
  4. 04

    用完即撤销

    撤销立即且永久生效；没有账户可用于找回。

    curl -X DELETE \
  -H "Authorization: Bearer $AENET_KEY" \
  "$ORIGIN/api/v1/keys/self"

S1 / KEY

暂停签发新的 API 密钥

服务准备期间暂不签发新密钥。公开读取无需密钥。现有密钥仍遵守原有有效期、配额及撤销规则，响应签名不变。恢复签发须经过版本就绪审批。

服务准备期间暂不签发新密钥。公开读取无需密钥。现有密钥仍遵守原有有效期、配额及撤销规则，响应签名不变。恢复签发须经过版本就绪审批。

方法路由描述

服务与版本

服务发现、状态、时间、发布版本与变更日志。

GET 读取 API.PUBLIC.13
/api/v1 Schema: aenet.public.api.index.v1 active beta · 0.4.0 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 short-lived SNAPSHOT_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.14
/api/v1/changelog Schema: aenet.public.changelog.v1 active beta · 0.4.0 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.22
/api/v1/openapi.json Schema: openapi.3.0.3 active beta · 0.5.0 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.21
/api/v1/policy Schema: aenet.public.api.policy.v1 active beta · 0.5.0 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot
所有者: Public API
GET 读取 API.PUBLIC.01
/api/v1/status Schema: aenet.public.status.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.02
/api/v1/time Schema: aenet.public.time.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 short-lived
所有者: Public Time
GET 读取 API.PUBLIC.15
/api/v1/version Schema: aenet.public.version-snapshot.v1 active beta · 0.4.0 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.16
/api/v1/versions Schema: aenet.public.versions.index.v1 active beta · 0.4.0 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.17
/api/v1/versions/{snapshotId} Schema: aenet.public.version-snapshot.v1 active beta · 0.4.0 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot VERSION_NOT_FOUNDSNAPSHOT_UNAVAILABLE
所有者: Public API

密钥与信任

签发、查看与撤销匿名只读密钥；获取签名公钥。

POST 写入 API.PUBLIC.23
/api/v1/keys Schema: aenet.public.api.key.v1 preview beta · 0.6.0

只读公共 API 契约：端点、信封与边界。

人机验证 INVALID_JSONINVALID_INPUTPAYLOAD_TOO_LARGEUNSUPPORTED_MEDIA_TYPETURNSTILE_FAILEDRATE_LIMITEDKEYS_UNAVAILABLE
所有者: Public API
DELETE 写入 API.PUBLIC.25
/api/v1/keys/self Schema: aenet.public.api.key-revoked.v1 active beta · 0.6.0

只读公共 API 契约：端点、信封与边界。

需要密钥 KEY_REQUIREDKEY_INVALIDKEY_EXPIREDKEY_RATE_LIMITEDKEYS_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.24
/api/v1/keys/self Schema: aenet.public.api.key-self.v1 active beta · 0.6.0

只读公共 API 契约：端点、信封与边界。

需要密钥 KEY_REQUIREDKEY_INVALIDKEY_EXPIREDKEY_RATE_LIMITEDKEYS_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.26
/api/v1/keys/signing-key Schema: aenet.public.api.signing-key.v1 active beta · 0.6.0 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 short-lived SIGNING_UNAVAILABLE
所有者: Public API

架构与路线图

经过脱敏的架构、开发队列与路线图快照。

GET 读取 API.PUBLIC.03
/api/v1/architecture Schema: aenet.public.architecture.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: Public API
GET 读取 API.PUBLIC.04
/api/v1/development-queue Schema: aenet.public.development-queue.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: Development Queue
GET 读取 API.PUBLIC.05
/api/v1/roadmap Schema: aenet.public.roadmap.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: Public API

钱包快照

只读的公共钱包系统证据与快照镜像。

GET 读取 API.PUBLIC.12
/public-data/*.json Schema: aenet.public.snapshot.* active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot
所有者: Public Snapshot Layer
GET 读取 API.PUBLIC.08
/api/v1/wallet Schema: aenet.public.wallet.overview.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: AENET Wallet
GET 读取 API.PUBLIC.09
/api/v1/wallet/architecture Schema: aenet.public.wallet.architecture.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: AENET Wallet
GET 读取 API.PUBLIC.18
/api/v1/wallet/capabilities Schema: aenet.public.wallet.evidence.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: AENET Wallet
GET 读取 API.PUBLIC.20
/api/v1/wallet/development Schema: aenet.public.wallet.evidence.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: AENET Wallet
GET 读取 API.PUBLIC.11
/api/v1/wallet/evidence Schema: aenet.public.wallet.evidence.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: AENET Wallet
GET 读取 API.PUBLIC.19
/api/v1/wallet/integration Schema: aenet.public.wallet.evidence.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: AENET Wallet
GET 读取 API.PUBLIC.10
/api/v1/wallet/security Schema: aenet.public.wallet.security.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot SNAPSHOT_UNAVAILABLE
所有者: AENET Wallet

抢先体验

候补名单状态与唯一的公共写入路径。

GET 读取 API.PUBLIC.06
/api/v1/early-access Schema: aenet.public.early-access.v1 active stable · v1 OPEN JSON ↗

只读公共 API 契约：端点、信封与边界。

开放 static-snapshot
所有者: Early Access
POST 写入 API.PUBLIC.07
/api/v1/early-access/register Schema: aenet.public.early-access.registration.v1 active beta · v1 OPEN FLOW ↗

只读公共 API 契约：端点、信封与边界。

人机验证 INVALID_JSONINVALID_INPUTINVALID_EMAILFORBIDDEN_FIELDINVALID_LOCALEINVALID_INTERESTSCONSENT_REQUIREDINVALID_USE_CASEINVALID_SESSION_IDTURNSTILE_REQUIREDTURNSTILE_FAILEDREQUEST_REJECTEDPAYLOAD_TOO_LARGEUNSUPPORTED_MEDIA_TYPERATE_LIMITEDREGISTRATION_UNAVAILABLEDUPLICATE
所有者: Early Access

S3

错误目录

所有错误使用相同信封与稳定的错误码。仅在标记处重试。

HTTP错误码重试含义
200DUPLICATE不可This email is already on the early-access list. Returned with HTTP 200 and the error envelope so the list is never revealed by status code.
400CONSENT_REQUIRED不可Consent is required.
400FORBIDDEN_FIELD不可The request carries a field that is never accepted.
400INVALID_EMAIL不可A valid email address is required.
400INVALID_INPUT不可The request body is not an acceptable object (unknown field, wrong shape).
400INVALID_INTERESTS不可Interests must be a short array of known interest areas.
400INVALID_JSON不可Request body must be valid JSON.
400INVALID_LOCALE不可Unsupported locale.
400INVALID_SESSION_ID不可Session id is not acceptable.
400INVALID_USE_CASE不可Use case must be text within the length limit.
400TURNSTILE_REQUIRED不可A Turnstile token is required.
401KEY_EXPIRED不可The API key has expired. Issue a new one.
401KEY_INVALID不可The API key is not valid.
401KEY_REQUIRED不可This endpoint needs an API key (Authorization: Bearer aek_…).
403PREVIEW_NOT_ENABLED不可The preview namespace is not enabled.
403REQUEST_REJECTED不可We could not accept this request. The rule that matched is never revealed.
403TURNSTILE_FAILED不可Verification failed.
404NOT_FOUND不可Public API route not found.
404VERSION_NOT_FOUND不可Version snapshot not found.
405METHOD_NOT_ALLOWED不可The method is not allowed for this route; the Allow header lists the valid methods.
413PAYLOAD_TOO_LARGE不可Request body too large.
415UNSUPPORTED_MEDIA_TYPE不可Content-Type must be application/json.
429KEY_RATE_LIMITED可以This API key exceeded its request quota.
429RATE_LIMITED可以Too many requests. Please try again later.
503KEYS_UNAVAILABLE可以API key issuance or verification is temporarily unavailable.
503REGISTRATION_UNAVAILABLE可以Registration is temporarily unavailable.
503SIGNING_UNAVAILABLE可以Response signing is not configured.
503SNAPSHOT_UNAVAILABLE可以Snapshot is temporarily unavailable.