📡 คู่มือการเรียกใช้ Key Genesis API (Technical Guide)

เอกสารนี้บันทึกวิธีการเรียกใช้งาน API สำหรับระบบ Licensing ของ GhostMicro เพื่อให้ AI และนักพัฒนาใช้งานได้อย่างถูกต้อง

---

🚀 สรุปขั้นตอนการเรียกใช้ (Proven Method)

เราใช้ curl หรือ fetch ในการส่งข้อมูลด้วย Method POST เสมอ

1. วิธีสร้างกุญแจ (Action: Encode)

ใช้เมื่อต้องการแปลงข้อมูลสินค้า/รหัสลับ ให้กลายเป็นวลี 12 คำ (GhostPass)

Command:

curl -X POST -H "Content-Type: application/json" \
-d '{
  "role": 1,
  "type": 0,
  "name": 500,
  "version": 1,
  "model": 88,
  "prodDate": 260105,
  "actDate": 0,
  "expiryDate": 2047,
  "sku": 777
}' \
https://key-genesis.vercel.app/api/encode

2. วิธีตรวจสอบกุญแจ (Action: Decode)

ใช้เมื่อต้องการอ่านข้อมูลจากวลี 12 คำ เพื่อตรวจสอบสิทธิ์การใช้งาน

Command:

curl -X POST -H "Content-Type: application/json" \
-d '{
  "phrase": "ability abandon discover abandon ability arch abuse abandon wrong gentle abandon notice"
}' \
https://key-genesis.vercel.app/api/decode

---

⚠️ ข้อควรระวัง

1. JSON Only: ต้องกำหนด Header Content-Type: application/json เสมอ
2. Master Secret: แม้ API จะทำงานแบบ Public ในขณะนี้ แต่ในอนาคตอาจมีการตรวจสอบ GHOSTPASS_MASTER_SECRET ในระดับ Server-side เพื่อความปลอดภัยสูงสุด
3. Mnemonic Checksum: คำที่ 12 ของวลีที่ได้รับ คือตัว Checksum หากมีการเปลี่ยนแม้แต่คำเดียว API จะตีกลับเป็น valid: false ทันที