Authentication

ทุก Request ที่ส่งไปยัง Platform API ต้องมี Header ที่จำเป็น 2 ตัวดังนี้

Header	จำเป็น	วัตถุประสงค์
API-Key	✅	API key ของคุณ สร้างได้จาก developer console
X-TenantID	✅	องค์กร (workspace) ที่ Request นั้นทำงานอยู่

curl "$ME_BASE/voice/providers" \
  -H "API-Key: $ME_API_KEY" \
  -H "X-TenantID: $ME_TENANT"

เก็บ Credentials ไว้ฝั่ง Server เท่านั้น

API-Key คือข้อมูลลับ ห้ามฝังไว้ในเบราว์เซอร์ แอปมือถือ หรือ Client ใดก็ตามที่คุณไม่ได้ควบคุม ให้ Proxy Request ผ่าน Backend ของคุณเองเสมอ

ขอบเขตที่ key เข้าถึงได้

Key ถือสิทธิ์ของเจ้าของ key ระบบจะยืนยันสิทธิ์ในฐานะผู้ใช้ที่เป็นเจ้าของ key เทียบกับองค์กรใน X-TenantID ดังนั้น key เข้าถึงได้เท่าที่เจ้าของเข้าถึงได้ ไม่มากกว่านั้น

Key ไม่ได้จำกัดสิทธิ์ให้แคบลงกว่าผู้ใช้คนนั้น ให้สร้าง key จากบัญชีที่มีสิทธิ์ตรงกับ ที่ระบบเชื่อมต่อต้องใช้จริง และเปลี่ยน key ทันทีหากหลุด

ข้อผิดพลาด

Status	ความหมาย	วิธีแก้ไข
401	API-Key หรือ X-TenantID หายไปหรือไม่ถูกต้อง	ตรวจสอบว่า Header ทั้งสองมีค่าและเป็นปัจจุบัน
400	Request Body ผิดรูปแบบ	ตรวจสอบให้ตรงกับ API Reference
404	ไม่พบ Resource ที่ระบุ	ตรวจสอบ Path และ {uuid} ให้ถูกต้อง

Response ของข้อผิดพลาดทุกประเภทมีโครงสร้างเดียวกัน:

{
  "code": "invalid_request",
  "message": "phone_number is required",
  "type": "validation"
}

Base URLs

Environment	Base URL
Production	https://api.messageeagle.com/api/v1/app1/platform
Sandbox	https://sandbox.messageeagle.com/api/v1/app1/platform

ไปต่อที่ SMS Messaging