SYS.DEV.01 D07 public-api

Public API

Public API v1 แบบอ่านอย่างเดียวของ AENET Cloud Public ให้บริการสถานะ เวลา สถาปัตยกรรม คิวพัฒนา โรดแมป และ early access พร้อมพื้นผิวที่มีขอบเขตเคร่งครัด

โดเมน: แพลตฟอร์มนักพัฒนา สถานะ: active ขอบเขตสาธารณะ: สังเกตเท่านั้น อัปเดตล่าสุด: 2026-08-16

KAP-GRID K.PUBLIC.SYSTEM.C03

รหัสระบบ

public-api

สถานะ

active

ชั้นสถาปัตยกรรม

L2 แอปพลิเคชันสาธารณะ (router)
L4 บริการสาธารณะ (API)

ข้อมูลนำเข้า

สแนปช็อต public-data และบริการ (status, time, architecture, queue, roadmap, early access)

ผลลัพธ์

การตอบสนอง JSON พร้อมเอนเวโลปที่สอดคล้องกัน ใบเสร็จการลงทะเบียน early access (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

ระบบที่เชื่อมต่อ

ขอบเขตความปลอดภัย

อ่านอย่างเดียวและมีขอบเขต เส้นทาง preview และส่วนตัวคืน 403 ไม่มีการรับรองตัวตน ไม่มีช่องเขียนนอกเหนือการลงทะเบียน early access ไม่มีการเข้าถึง core

ทิศทางข้อมูล

สแนปช็อตสาธารณะ → การตอบสนอง API (อ่าน) การลงทะเบียน early access → D1 (เส้นทางเขียนเพียงเส้นเดียว ไม่เคยไปยัง core)

อินเทอร์เฟซสาธารณะ

สร้างจากทะเบียน 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 อ่านอย่างเดียว

ความปลอดภัย

คืออะไร

เปิดเผยข้อมูลที่ปลอดภัยสาธารณะและอ่านอย่างเดียวในสัญญา JSON ที่มีโครงสร้าง พร้อมทำให้เส้นทางส่วนตัวทั้งหมดอยู่นอกเหนือการเข้าถึง

ทำไม

ผู้เยี่ยมชมและนักพัฒนาต้องการข้อมูลสาธารณะที่เครื่องอ่านได้โดยไม่มีเส้นทางสู่ระบบส่วนตัวหรือภายใน Public API แก้ด้วยสัญญา v1 เอนเวโลป และการควบคุมเส้นทางต้องห้าม/ส่วนตัว

อย่างไร

ให้บริการ 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 การลงทะเบียน)
ปฏิเสธเส้นทาง preview/ส่วนตัวด้วย 403
บังคับใช้เอนเวโลป API ที่สอดคล้องกัน

ตัวอย่าง

นักพัฒนาเรียก GET /api/v1/time และได้รับ envelope ที่มีเวอร์ชัน {ok, schema, requestId, issuedAt, data} — อ่านอย่างเดียว ไม่มีการยืนยันตัวตน ไม่เข้าถึง core

ข้อมูลนำเข้า

สแนปช็อต public-data และบริการ (status, time, architecture, queue, roadmap, early access)

ผลลัพธ์

การตอบสนอง JSON พร้อมเอนเวโลปที่สอดคล้องกัน ใบเสร็จการลงทะเบียน early access (D1)

สิ่งที่พึ่งพา

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

วงจรชีวิต

สัญญา v1
เอนเวโลป
การควบคุมเส้นทาง
เอกสาร openapi.public.json

กรณีใช้งาน

นักพัฒนาอ่านสัญญาและตัวอย่าง Public API
ผู้เยี่ยมชมตรวจสถานะและเวลาสาธารณะผ่าน API
บุคคลลงทะเบียน early access

ข้อจำกัด

อ่านอย่างเดียวโดยการออกแบบ — ไม่มี API เขียนนอกเหนือ early access
ไม่ออกคีย์ API (keyIssuanceDisabled)
เส้นทาง preview ไม่พร้อมใช้งานโดยตั้งใจ
สคีมาภายในและเส้นทางส่วนตัวไม่ถูกเผยแพร่

ระบบที่เชื่อมต่อ

AENET Cloud Public — ทางเข้าด้านสาธารณะและชั้นสังเกตการณ์ของระบบนิเวศ AENET เผยแพร่สแนปช็อตที่ผ่านการทำความสะอาด หน้าเว็บแบบสถิต Public API และช่องทางการจราจรแบบไม่ระบุตัวตน เท่านั้น
AENET Core — ระบบนิเวศส่วนตัวของ AENET ไม่สามารถเข้าถึงจากอินเทอร์เน็ตสาธารณะได้ และสามารถส่งออกได้เฉพาะสแนปช็อตสาธารณะที่ทำความสะอาดแล้วไปยัง aenet-cloud-public ผ่านสัญญาสแนปช็อตเท่านั้น
AENET Wallet — สถาปัตยกรรมกระเป๋า Bitcoin แบบ watch-only เก็บข้อมูลในเครื่อง มีการเซ็นชื่อจากภายนอก และผสานกับเครื่องผ่าน Rust ระบบปฏิบัติการส่วนตัวของระบบนิเวศ AENET ฝั่งสาธารณะสังเกตได้เฉพาะสแนปช็อตที่ทำความสะอาดแล้ว
Development Queue — มุมมองสาธารณะว่าระบบ AENET กำลังสร้างอะไร — สเตตแมชชีน (DISCOVERED → SPECIFIED → BUILDING → VERIFYING → PREVIEW → RELEASED) โดยไม่มีเปอร์เซ็นต์ความคืบหน้าปลอม
Early Access — รายชื่อรอสาธารณะสำหรับทดสอบเกตเวย์สาธารณะ AENET บันทึกผู้สมัครอยู่เฉพาะใน D1 ไม่ถูกจัดทำดัชนี ส่งออก หรือเผยแพร่ และการลงทะเบียนล้มเหลว-ปิดเมื่อไม่มีการยืนยัน Turnstile
KAP Language — รูปแบบสัญญาประกาศที่ใช้ทั่วคลังนี้เพื่ออธิบายเว็บสาธารณะ การนำทาง เนื้อหา เลย์เอาต์ มอชัน เวลา การจราจร และ early access ในไฟล์ที่เครื่องอ่านได้ (.kap)
Public Snapshot Layer — ชั้นที่เผยแพร่สแนปช็อต JSON ที่ทำความสะอาดและสร้างไว้ล่วงหน้า (site, status, architecture, articles, roadmap, queue, topology, traffic summary) จาก public-data/
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 early access ทำงานอย่างไร?

หลักฐาน

เฉพาะสถานะที่ตรวจสอบแล้ว — ไม่มีอะไรบนหน้านี้คือการคาดการณ์

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

Public API

รหัสระบบ

สถานะ

ชั้นสถาปัตยกรรม

ข้อมูลนำเข้า

ผลลัพธ์

อินเทอร์เฟซสาธารณะ

ระบบที่เชื่อมต่อ

ขอบเขตความปลอดภัย

ทิศทางข้อมูล

อินเทอร์เฟซสาธารณะ

ความปลอดภัย

คืออะไร

ทำไม

อย่างไร

ตัวอย่าง

ข้อมูลนำเข้า

ผลลัพธ์

สิ่งที่พึ่งพา

วงจรชีวิต

กรณีใช้งาน

ข้อจำกัด

ระบบที่เชื่อมต่อ

งานวิจัยที่เกี่ยวข้อง

คำถามที่ผู้คนถาม

หลักฐาน

ขั้นตอนถัดไป