Kingdoms Isle
KINGDOMS ISLEAI RULE ASSISTANT
KINGDOMS ISLE · CONTROL ROOM

API & Connection

จัดการการเชื่อมต่อ AI Assistance และดูวิธีเชื่อมเว็บไซต์กับ API

ADMIN ACCESS
01 · ADMIN AUTHENTICATION

เข้าสู่หน้าตั้งค่า

ใช้ ADMIN_API_KEY จากไฟล์ .env ของเซิร์ฟเวอร์ คีย์ที่กรอกจะอยู่ในหน่วยความจำของหน้านี้เท่านั้น

02 · PROVIDER & API KEYS

การเชื่อมต่อผู้ช่วย AI

LOCKED

เข้าสู่ระบบเพื่อดูสถานะคีย์ เปลี่ยน Gemini key และทดสอบการเชื่อมต่อ

03 · API REFERENCE

Endpoints สำหรับเชื่อมต่อ

GET
/api/health

ตรวจสอบสถานะระบบ

Public
POST
/api/chat

รับคำตอบแบบ JSON

ผ่าน server proxy
POST
/api/chat/stream

รับสถานะและคำตอบผ่าน SSE

ผ่าน server proxy
04 · QUICK START

วิธีเชื่อมต่อ

  1. ตั้งค่าเซิร์ฟเวอร์

    กำหนด GOOGLE_API_KEY, ADMIN_API_KEY, CHAT_API_KEY และ BACKEND_URL ใน .env แล้วเริ่ม backend และเว็บ ดูคำสั่งใน README ของโปรเจกต์

  2. ตรวจสอบการเชื่อมต่อ

    เข้าสู่หน้านี้ กดทดสอบการเชื่อมต่อ แล้วเปิด AI Assistance เพื่อส่งคำถามจริง

  3. เรียกผ่านเว็บไซต์เดียวกัน

    ใช้ /api/chat หรือ /api/chat/stream โดย server proxy จะเพิ่ม CHAT_API_KEY ให้ หากเชื่อมจากระบบอื่น ให้เรียก backend โดยตรงด้วย Authorization: Bearer YOUR_CHAT_API_KEY และเก็บคีย์ในเซิร์ฟเวอร์ของระบบนั้น

  4. ใช้บทสนทนาต่อเนื่อง

    คำตอบแรกจะมี conversation_id ส่งค่านี้ในคำถามถัดไป และเก็บ session cookie ไว้ด้วย

JAVASCRIPT · SAME-ORIGIN
fetch("/api/chat", {
  method: "POST",
  credentials: "same-origin",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    message: "Allosaurus อยู่เป็นกลุ่มได้กี่ตัว?",
    language: "th"
  })
}).then(r => r.json()).then(console.log);