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

public-api

Public API

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

สถานะ: active อัปเดตล่าสุด: 2026-08-16

รหัสระบบ

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

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

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

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

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

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

คืออะไร

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

ทำไม

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

อย่างไร

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

  • ให้บริการ 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 การลงทะเบียน)
  • ปฏิเสธเส้นทาง 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 ผ่านสัญญาสแนปช็อตเท่านั้น
  • 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

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