AENET ecosystems เกตเวย์สาธารณะ
ขายบน AENET · Early Access
GATEWAY READY
ENไทย中文
KAP-GRID / Y C01
พื้นผิวสาธารณะพร้อมใช้งาน

K.PUBLIC.API / D.LAYOUT.CONTROL

Public API ของ AENET

Public API v1 แบบอ่านอย่างเดียว: อ่านได้แบบเปิด คีย์ไม่ระบุตัวตนแบบไม่บังคับ การตอบกลับที่ลงลายเซ็น ทะเบียนจุดเชื่อมต่อ และรายการข้อผิดพลาด

พักการออกคีย์ API ใหม่ชั่วคราว — ระบบพักการออกคีย์ใหม่ระหว่างเตรียมความพร้อมบริการ การอ่านข้อมูลสาธารณะไม่ต้องใช้คีย์ คีย์เดิมยังอยู่ภายใต้วันหมดอายุ โควตา และการเพิกถอนเดิม โดยไม่เปลี่ยนระบบเซ็นคำตอบ จะเปิดออกคีย์อีกครั้งหลังอนุมัติความพร้อมของรุ่นบริการ

เวอร์ชันv1
เส้นทางฐาน/api/v1
การเข้าถึงเปิด · คีย์ไม่บังคับ
การตอบกลับที่ลงลายเซ็นed25519

สัญญาสาธารณะ

ทะเบียนจุดเชื่อมต่อ

จุดเชื่อมต่อ26
อ่านอย่างเดียว23
เส้นทางเขียน3
เปิด22
D01REQUEST D02KEY OPTIONAL D03ROUTE D04SNAPSHOT D05ENVELOPE D06CACHE D07SIGNED D08EVIDENCE

S1

เริ่มต้นใช้งาน

สี่คำสั่งครอบคลุมวงจรทั้งหมด การอ่านไม่ต้องใช้คีย์ คีย์เพิ่มโควตาที่เพิกถอนได้

  1. 01

    เรียกโดยไม่ใช้คีย์

    ทุก GET ที่ระบุว่า Open ตอบกลับแบบไม่ระบุตัวตนในรูปแบบ JSON envelope

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

    พักการออกคีย์ API ใหม่ชั่วคราว

    ระบบพักการออกคีย์ใหม่ระหว่างเตรียมความพร้อมบริการ การอ่านข้อมูลสาธารณะไม่ต้องใช้คีย์ คีย์เดิมยังอยู่ภายใต้วันหมดอายุ โควตา และการเพิกถอนเดิม โดยไม่เปลี่ยนระบบเซ็นคำตอบ จะเปิดออกคีย์อีกครั้งหลังอนุมัติความพร้อมของรุ่นบริการ

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

    ตรวจลายเซ็น

    ทุกการตอบกลับ JSON ลงลายเซ็น Ed25519 ให้ปักหมุด key 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public API แบบอ่านอย่างเดียว: จุดเชื่อมต่อ เอนเวโลป และขอบเขต

เปิด static-snapshot
เจ้าของ: Public API
GET อ่าน API.PUBLIC.01
/api/v1/status Schema: aenet.public.status.v1 active stable · v1 OPEN JSON ↗

สัญญา Public API แบบอ่านอย่างเดียว: จุดเชื่อมต่อ เอนเวโลป และขอบเขต

เปิด static-snapshot SNAPSHOT_UNAVAILABLE
เจ้าของ: Public API
GET อ่าน API.PUBLIC.02
/api/v1/time Schema: aenet.public.time.v1 active stable · v1 OPEN JSON ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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

สัญญา Public 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

สัญญา Public 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

สัญญา Public 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 ↗

สัญญา Public API แบบอ่านอย่างเดียว: จุดเชื่อมต่อ เอนเวโลป และขอบเขต

เปิด short-lived SIGNING_UNAVAILABLE
เจ้าของ: Public API

สถาปัตยกรรมและแผนงาน

สแนปชอตสถาปัตยกรรม คิวพัฒนา และแผนงานที่ผ่านการทำความสะอาดแล้ว

GET อ่าน API.PUBLIC.03
/api/v1/architecture Schema: aenet.public.architecture.v1 active stable · v1 OPEN JSON ↗

สัญญา Public 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 ↗

สัญญา Public API แบบอ่านอย่างเดียว: จุดเชื่อมต่อ เอนเวโลป และขอบเขต

เปิด static-snapshot SNAPSHOT_UNAVAILABLE
เจ้าของ: Development Queue
GET อ่าน API.PUBLIC.05
/api/v1/roadmap Schema: aenet.public.roadmap.v1 active stable · v1 OPEN JSON ↗

สัญญา Public API แบบอ่านอย่างเดียว: จุดเชื่อมต่อ เอนเวโลป และขอบเขต

เปิด static-snapshot SNAPSHOT_UNAVAILABLE
เจ้าของ: Public API

สแนปชอตกระเป๋า

หลักฐานระบบกระเป๋าสาธารณะแบบอ่านอย่างเดียวและสำเนาสแนปชอต

GET อ่าน API.PUBLIC.12
/public-data/*.json Schema: aenet.public.snapshot.* active stable · v1 OPEN JSON ↗

สัญญา Public API แบบอ่านอย่างเดียว: จุดเชื่อมต่อ เอนเวโลป และขอบเขต

เปิด static-snapshot
เจ้าของ: Public Snapshot Layer
GET อ่าน API.PUBLIC.08
/api/v1/wallet Schema: aenet.public.wallet.overview.v1 active stable · v1 OPEN JSON ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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 ↗

สัญญา Public 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

รายการข้อผิดพลาด

ทุกข้อผิดพลาดใช้ envelope เดียวกันพร้อมรหัสที่คงที่ ลองใหม่เฉพาะรายการที่ระบุ

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.