DocsAPI Documentation

Get started

Alsentia API ช่วยให้คุณวิเคราะห์ธุรกรรมทางการเงินจากข้อความและเสียงได้อย่างง่ายดาย พร้อม AI ที่เข้าใจภาษาไทย

🚀 Quick Start

เริ่มใช้งานได้ทันทีด้วย REST API - ไม่ต้องติดตั้ง SDK

1. สร้างAPI Key→ 2. เรียก API → 3. รับผลลัพธ์

Authentication

ใช้ API Key ในการยืนยันตัวตน สามารถสร้างได้จากหน้า API Keys

เพิ่ม API Key ใน Header

X-API-Key: your_api_key_here

💡 Tip: เก็บ API Key ไว้ใน environment variables

⚠️ Warning: อย่า commit API Key ลง Git

Your first request

ส่งข้อความเพื่อวิเคราะห์ธุรกรรมทางการเงิน

const response = await fetch('https://alsentia.com/api/transactions/text', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
  },
  body: JSON.stringify({
    text: "ซื้อกาแฟ 50 บาท",
    userId: "user123"
  })
});

const data = await response.json();
console.log(data);

Response

{
  "success": true,
  "results": [{
    "status": "auto_confirmed",
    "confidence": 0.90,
    "transaction": {
      "type": "expense",
      "amount": 50,
      "category": "food",
      "description": "กาแฟ"
    }
  }]
}

API Endpoints

POST/api/transactions/text

วิเคราะห์ข้อความและสร้างธุรกรรม

Request Body

{
  "text": "ซื้อกาแฟ 50 บาท",
  "userId": "user123"
}

Response

{
  "success": true,
  "results": [{
    "status": "auto_confirmed",
    "confidence": 0.90,
    "transaction": {
      "type": "expense",
      "amount": 50,
      "category": "food"
    }
  }]
}
POST/api/transactions/voice

อัพโหลดไฟล์เสียงเพื่อวิเคราะห์

Request (FormData)

audio: File (wav, mp3, webm, etc.)
userId: "user123"

Response

{
  "success": true,
  "text": "ซื้อข้าว 50 บาท",
  "transactions": [...]
}
GET/api/transactions

ดึงข้อมูลธุรกรรมทั้งหมด

Query Parameters

userId: "user123" (required)
type: "expense" | "income" (optional)
category: "food" (optional)

More Examples

อัพโหลดไฟล์เสียง

const formData = new FormData();
formData.append('audio', audioFile);
formData.append('userId', 'user123');

const response = await fetch('https://alsentia.com/api/transactions/voice', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your_api_key_here'
  },
  body: formData
});

ดึงข้อมูลธุรกรรม

const response = await fetch(
  'https://alsentia.com/api/transactions?userId=user123&type=expense',
  {
    headers: {
      'X-API-Key': 'your_api_key_here'
    }
  }
);

Next steps

สร้าง API Key

จัดการ API Keys และตั้งค่า rate limits

SDK (Coming Soon)

JavaScript/TypeScript SDK กำลังพัฒนา