# 02 — Maycur API (สรุปจาก `03 API.docx`)

> ที่มา: `C:\Users\mokun\Downloads\03 API.docx` (เนื้อหาในไฟล์เป็นตาราง 2 คอลัมน์ จีน/อังกฤษ — ด้านล่างคือคำแปลเต็ม)

## เนื้อหาต้นฉบับ (แปล)

**API信息 / API informations**

1. **เอกสาร API ทางการ (Official API Documentation)**: `https://openapi-doc.maycur.com/`
2. **Request Endpoints** (โจทย์กำกับ: "please confirm which version you are using")
   - Production: `https://www.maycur.com` **หรือ** `https://www2.maycur.com`
   - UAT: `https://uat.maycur.com`
3. **Authentication Method (การยืนยันตัวตน)**
   - ขอ **Token** ด้วย `appCode` และ `appSecret`
   - **Token มีอายุ 30 นาที**

## ข้อวิเคราะห์สำหรับ POC

| ประเด็น | รายละเอียด |
|---|---|
| **สิ่งที่ยังไม่มี** | `appCode` / `appSecret` + การยืนยัน environment (PROD `www`/`www2` หรือ UAT) — ต้องขอจากลูกค้าก่อนต่อ API จริง |
| **Token lifecycle** | อายุ 30 นาที → ต้องมี refresh logic ใน integration (ขอใหม่ก่อนหมดอายุ) |
| **ขอบเขตที่ต้องอ่านเพิ่ม** | ต้องเปิด `https://openapi-doc.maycur.com/` เพื่อระบุ endpoint ที่ใช้จริง: list/detail ของ flow (报销单), attachments/ไฟล์แนบ, approval records, invoice metadata |
| **แนวทาง POC** | ① Fetch flow + attachments จาก Maycur API → ② แปลงเอกสารเป็น PNG (PyMuPDF) → ③ AI vision สกัดข้อมูล (ชื่อนิติ, เลขใบกำกับ, ยอด, VAT/WHT, ลายเซ็น) → ④ Rule engine ตรวจตามโจทย์ → ⑤ รายงานผล |
| **โหมดสำรอง** | ระหว่างรอ credential ใช้ **offline replay** จากชุดเอกสารที่ให้มา (ทำได้ทันที — พิสูจน์แล้วใน `04`) |
| **ความเสี่ยง** | ยังไม่ทดสอบ API จริง — ต้อง validate rate limit, pagination, รูปแบบไฟล์แนบ (PDF/รูป/Excel) เมื่อได้ credential |