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/leasePOST /installations/heartbeatPOST /installations/events
Header:
X-AG-Installation: installation UUIDX-AG-Timestamp: Unix secondsX-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