ตัวอย่าง cURL

ตัวอย่างคำสั่ง cURL สำหรับใช้งาน EasySlip API

TIP

EasySlip API ใช้ HMAC-SHA256 Authentication ใช้ HMAC headers (X-API-Key, X-Timestamp, X-Nonce, X-Signature) ดูคู่มือ Authentication สำหรับ implementation เต็ม

Authentication

ทุก Request ต้องมี HMAC headers ดูคู่มือ Authentication สำหรับรายละเอียด

ตรวจสอบสลิปธนาคาร

ตรวจสอบด้วย Payload

curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "00020101021230..."
  }'

ตรวจสอบด้วย Account Matching

curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "00020101021230...",
    "receiverAccount": "1234567890",
    "amount": 1000.00
  }'

ตรวจสอบด้วยรูปภาพ

curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/slip.jpg" \
  -F "checkDuplicate=true" \
  -F "receiverAccount=1234567890"

ข้อมูลบัญชี

curl https://api.easyslip.com/v2/info \
  -H "Authorization: Bearer YOUR_API_KEY"

ใช้งานกับ Environment Variables

# ตั้งค่า API Key
export EASYSLIP_API_KEY="your-branch-uuid"
export EASYSLIP_SECRET_KEY="your-secret-key"

# ตรวจสอบสลิป (ต้องสร้าง HMAC signature ก่อน)
# ดู Authentication Guide สำหรับวิธีสร้าง signature
curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "X-API-Key: $EASYSLIP_API_KEY" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "00020101021230..."
  }'

แสดง Response แบบสวยงาม

# ใช้ jq สำหรับ format JSON (หลังจากสร้าง HMAC headers แล้ว)
curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "X-API-Key: ${API_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d '{"payload": "00020101021230..."}' | jq .

Debug Mode

# แสดง request และ response headers
curl -v -X POST https://api.easyslip.com/v2/verify/bank \
  -H "X-API-Key: ${API_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d '{"payload": "00020101021230..."}'

ตัวอย่าง Response

สำเร็จ

{
  "success": true,
  "data": {
    "rawSlip": {
      "payload": "00020101021230...",
      "transRef": "2024011512345678",
      "date": "2024-01-15T10:30:00+07:00",
      "countryCode": "TH",
      "amount": {
        "amount": 1000.00,
        "local": {
          "amount": 1000.00,
          "currency": "THB"
        }
      },
      "sender": {
        "bank": {
          "id": "004",
          "name": "กสิกรไทย",
          "short": "KBANK"
        },
        "account": {
          "name": {
            "th": "นาย ผู้โอน ทดสอบ"
          }
        }
      },
      "receiver": {
        "bank": {
          "id": "014",
          "name": "ไทยพาณิชย์",
          "short": "SCB"
        },
        "account": {
          "name": {
            "th": "นาย รับเงิน ทดสอบ"
          }
        }
      }
    }
  },
  "message": "Bank slip verified successfully"
}

Error

{
  "success": false,
  "error": {
    "code": "SLIP_NOT_FOUND",
    "message": "The slip could not be found or is invalid"
  }
}

รหัส HTTP Status

Status	ความหมาย
200	สำเร็จ
400	Request ไม่ถูกต้อง
401	ไม่ได้รับอนุญาต
404	ไม่พบข้อมูล
429	เรียกใช้ API มากเกินไป
500	Server Error

ที่เกี่ยวข้อง

• ตัวอย่าง JavaScript
• ตัวอย่าง PHP
• ตัวอย่าง Python