Skip to content

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

ทุก Request ที่ส่งไป EasySlip API ต้องยืนยันตัวตนด้วย Bearer Token

รับ API Key ​

  1. เข้าสู่ระบบที่ EasySlip Developer Portal
  2. ไปที่หน้า Dashboard ของแอปพลิเคชัน
  3. คัดลอก 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-here
javascript
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 ที่กำหนด:

  1. ไปที่ ตั้งค่าแอปพลิเคชัน
  2. เพิ่ม IP Address ของ Server ลงใน Whitelist
  3. ใช้ * เพื่ออนุญาตทุก 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 ได้
  • แบ่งโควต้าให้แต่ละทีมได้

ขั้นตอนถัดไป ​

Bank Slip Verification API for Thai Banking