API สำหรับปลั๊กอิน

Base URL: https://<โดเมนแพลตฟอร์ม>/api/v1

การลงทะเบียน

POST /installations/register

{
  "product": "aegishider",
  "installation_uuid": "3f1c2a90-...",
  "public_key": "<base64 SPKI DER>",
  "fingerprint_sha256": "<hex>",
  "plugin_version": "3.3.0",
  "minecraft_version": "1.21.11",
  "platform": "Paper",
  "java_version": "21"
}

ตอบกลับด้วย installation_id, activation_code, activation_expires_at, portal_url

คำขอที่ต้องลงนาม

  • POST /installations/lease
  • POST /installations/heartbeat
  • POST /installations/events

Header:

  • X-AG-Installation: installation UUID
  • X-AG-Timestamp: Unix seconds
  • X-AG-Nonce: base64url 32 ไบต์ (ใช้ครั้งเดียว)
  • X-AG-Signature: base64 Ed25519

ข้อความที่ลงนาม:

METHOD + "\n" +
pathname + "\n" +
installation_uuid + "\n" +
timestamp + "\n" +
nonce + "\n" +
lowercase_hex_sha256(rawBodyBytes)

Lease

{ "lease": "<payloadB64url>.<sigB64url>", "key_id": "...", "expires_at": 1730000000, "keys": [...] }

Payload คือ JSON canonical ที่มี license_id, installation_uuid, entitlements, issued_at, expires_at, key_id ตรวจลายเซ็นจากไบต์ของ payload โดยตรง (ไม่ต้อง serialize ใหม่)

Public keys

GET /license/keys → { "data": { "keys": [{ "key_id": "...", "public_key": "..." }] } }

Error format

{ "error": { "code": "invalid_signature", "message": "...", "request_id": "req_..." } }

อัปเดต 2026-11 · Aegishider Control Platform