การยืนยันตัวตน

รับ API key

1. เข้าสู่ระบบ dashboard ของ Gowajee ด้วยบัญชี Owner หรือ Admin role อื่นจะมองไม่เห็น key
2. เปิด ระบบ → นักพัฒนา หน้านี้ชื่อ การตั้งค่านักพัฒนา
3. ในส่วน API Key กดไอคอนรูปตาเพื่อแสดง key แล้วคัดลอก
4. เก็บ key ไว้บน server เช่นเก็บเป็น environment variable ชื่อ GOWAJEE_API_KEY

• Key ขึ้นต้นด้วย gw_ แล้วตามด้วยตัวอักษรอีก 32 ตัว
• แต่ละองค์กรมี key เดียว และ key นี้ดูและสั่งงาน ทุก campaign ในองค์กร ได้
• ปุ่ม สร้าง API Key ใหม่ (Regenerate) ในหน้าเดียวกันจะออก key ใหม่มาแทน key เก่าใช้ไม่ได้ ทันที และ request ที่ยังใช้ key เก่าจะได้ 401 สร้าง key ใหม่แล้วให้เอาไปอัปเดตในทุกระบบทันที

ส่ง key มากับทุก request

ใส่ key ไว้ใน header X-API-Key ของทุก request ที่เรียก /api/*

GET /api/agent/list HTTP/1.1
Host: api.voice-agent.gowajee.ai
X-API-Key: gw_3f9a1c2e7b4d4e0a9c8b1f2d3e4a5b6c

ชื่อ header ไม่แยกตัวพิมพ์เล็กพิมพ์ใหญ่ ส่งเป็น x-api-key ก็ได้

Base URL

https://api.voice-agent.gowajee.ai

path ทุกตัวในเอกสารนี้ขึ้นต้นด้วย /api/... และต่อท้าย URL นี้ รองรับเฉพาะ HTTPS

เก็บ key ไว้ฝั่ง server เท่านั้น

อย่าใส่ key ไว้ในหน้าเว็บ แอปมือถือ หรือ repository สาธารณะ ใครได้ key ไปก็สร้าง campaign ที่โทรหาเบอร์จริงในบัญชีของคุณได้ ถ้า key หลุด ให้สร้าง key ใหม่ทันที

Error ของการยืนยันตัวตน

กรณี	Status	code	message
ไม่ได้ส่ง header X-API-Key มา	401	API_KEY_REQUIRED	API key is required
Key ผิด หรือเป็น key เก่าที่สร้างใหม่ไปแล้ว	401	INVALID_API_KEY	Invalid API key
องค์กรยังไม่ได้รับสิทธิ์โทรออก (เจอเฉพาะตอนเริ่ม campaign)	403	CALLING_NOT_ALLOWED	Your organization is not allowed to make calls.

Body ใช้โครงสร้าง error มาตรฐานเหมือน error อื่น ๆ

{
  "success": false,
  "statusCode": 401,
  "code": "INVALID_API_KEY",
  "message": "Invalid API key",
  "errors": ["Invalid API key"]
}