การยืนยันตัวตน
ทุก Request ที่ส่งไป EasySlip API ต้องยืนยันตัวตนด้วย Bearer Token
รับ API Key
- เข้าสู่ระบบที่ EasySlip Developer Portal
- ไปที่หน้า Dashboard ของแอปพลิเคชัน
- คัดลอก API Key จากส่วน Credentials
ใช้งาน API Key
ใส่ API Key ใน Header Authorization ของทุก Request:
http
Authorization: Bearer YOUR_API_KEYตัวอย่าง Request
bash
curl -X GET https://api.easyslip.com/v2/info \
-H "Authorization: Bearer YOUR_API_KEY"รูปแบบ API Key
API Key ของ EasySlip เป็นรูปแบบ UUID v4:
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxตัวอย่าง: a1b2c3d4-e5f6-7890-abcd-ef1234567890
แนวทางปฏิบัติด้านความปลอดภัย
1. อย่าเปิดเผย Key ในโค้ด Client-side
javascript
// ❌ ไม่ควรทำ
const API_KEY = 'your-api-key-here';
// ✅ ควรทำ - ใช้ Environment Variables
const API_KEY = process.env.EASYSLIP_API_KEY;2. ใช้ Environment Variables
bash
EASYSLIP_API_KEY=your-api-key-herejavascript
import 'dotenv/config';
const apiKey = process.env.EASYSLIP_API_KEY;php
$apiKey = getenv('EASYSLIP_API_KEY');
// หรือ
$apiKey = $_ENV['EASYSLIP_API_KEY'];python
import os
api_key = os.environ.get('EASYSLIP_API_KEY')3. ทำ Request จาก Server เท่านั้น
เรียก API จากฝั่ง Server เสมอ อย่าเรียกจาก JavaScript ฝั่ง Client:
javascript
// ❌ ไม่ควรทำ - Client-side request เปิดเผย API key
fetch('https://api.easyslip.com/v2/verify/bank', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
// ✅ ควรทำ - Request ผ่าน Server ของคุณ
fetch('/api/verify-slip', {
method: 'POST',
body: JSON.stringify({ image: slipImage })
});4. IP Whitelisting
ตั้ง IP Whitelist ใน Developer Portal เพื่อให้เรียก API ได้เฉพาะจาก IP ที่กำหนด:
- ไปที่ ตั้งค่าแอปพลิเคชัน
- เพิ่ม IP Address ของ Server ลงใน Whitelist
- ใช้
*เพื่ออนุญาตทุก IP (ไม่แนะนำสำหรับ Production)
ข้อผิดพลาดการยืนยันตัวตน
ไม่มี API Key (401)
json
{
"success": false,
"error": {
"code": "MISSING_API_KEY",
"message": "Authorization header is required"
}
}วิธีแก้ไข: ใส่ Header Authorization: Bearer YOUR_API_KEY
API Key ไม่ถูกต้อง (401)
json
{
"success": false,
"error": {
"code": "INVALID_API_KEY",
"message": "The provided API key is invalid"
}
}วิธีแก้ไข: ตรวจว่า API Key ถูกต้องและยังไม่ถูกยกเลิก
IP ไม่อนุญาต (403)
json
{
"success": false,
"error": {
"code": "IP_NOT_ALLOWED",
"message": "Your IP address is not in the allowed list"
}
}วิธีแก้ไข: เพิ่ม IP ของ Server ลงใน Whitelist ใน Developer Portal
Branch ถูกปิดใช้งาน (403)
json
{
"success": false,
"error": {
"code": "BRANCH_INACTIVE",
"message": "This API branch has been deactivated"
}
}วิธีแก้ไข: เปิดใช้งาน Branch อีกครั้งใน Developer Portal หรือติดต่อ Support
เกินโควต้า (403)
json
{
"success": false,
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Your API quota has been exceeded"
}
}วิธีแก้ไข: อัพเกรดแพ็กเกจ หรือรอให้โควต้ารีเซ็ต
รองรับหลาย Branch (v2)
API v2 รองรับหลาย Branch ต่อแอปพลิเคชัน แต่ละ Branch มี API Key แยกกัน:
- Main Branch: API Key หลัก มีโควต้าเต็ม
- Sub-Branches: API Key เพิ่มเติม มีการติดตามโควต้าแยก
การแยก Branch ทำให้:
- ดูการใช้งานแยกตามจุดเชื่อมต่อได้
- ตั้ง IP Restrictions ต่างกันในแต่ละ Branch ได้
- แบ่งโควต้าให้แต่ละทีมได้
ขั้นตอนถัดไป
- เปรียบเทียบเวอร์ชัน - API v1 ต่างจาก v2 อย่างไร
- API v2 Reference - Endpoint ทั้งหมดของ v2
- รหัสข้อผิดพลาด - รายการ Error Code ทั้งหมด