# API Usage Examples — ตัวอย่างการใช้งาน API

**GOFLOW Enterprise AI OS Master Package v4.0** · ต่อจาก [api-index.md](api-index.md)

## 1. สมัครสมาชิก + เข้าสู่ระบบ

```bash
# ลงทะเบียน
curl -X POST https://api.goflow.click/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"dev@goflow.click","password":"secure-pass-123","name":"Dev Team"}'

# เข้าสู่ระบบ
curl -X POST https://api.goflow.click/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"dev@goflow.click","password":"secure-pass-123"}'
# → { "accessToken": "...", "refreshToken": "...", "user": { ... } }
```

## 2. ถาม NEXUS AI (RAG + Memory Fusion)

```typescript
// TypeScript (Fastify client)
const res = await fetch("https://api.goflow.click/v1/ai/chat", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    message: "เริ่มงาน Backend ต้องเรียนรู้อะไร",
    reasoningMode: "rag-memory-intelligence-fusion-reasoning-v7.3",
  }),
});
const data = await res.json();
console.log(data.reply);
// data.sources → [{ docId: "ENG-70", title: "Engineering Handbook", ... }]
```

## 3. ค้นหาความรู้ (Knowledge Search)

```bash
curl -X POST https://api.goflow.click/v1/knowledge/search \
  -H "Content-Type: application/json" \
  -d '{"query":"CI/CD pipeline","os":"ENG","limit":5}'
```

## 4. สมัครงาน (Recruitment)

```bash
curl -X POST https://api.goflow.click/v1/applications \
  -F "positionId=lead-full-stack" \
  -F "name=สมชาย ใจดี" \
  -F "email=user@example.com" \
  -F "resume=@resume.pdf"
```

## 5. จอง Demo

```bash
curl -X POST https://api.goflow.click/v1/bookings \
  -H "Content-Type: application/json" \
  -d '{
    "name": "บริษัทตัวอย่าง",
    "email": "cto@example.com",
    "product": "Enterprise OS",
    "date": "2026-08-20"
  }'
```

## 6. Wallet — เช็คยอดและโอนเงิน

```bash
curl https://api.goflow.click/v1/wallet/balance \
  -H "Authorization: Bearer $TOKEN"
# → { "balance": 12500.50, "currency": "THB" }

curl -X POST https://api.goflow.click/v1/wallet/transfer \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"toUserId":"usr_123","amount":500}'
```

## หมายเหตุ

- ทุกคำขอต้องมี `Authorization: Bearer <token>` (ยกเว้น register/login/contact)
- อ่านสเปกเต็ม: [openapi.yaml](openapi.yaml) · มาตรฐาน error: [ENG-16](../docs/engineering-os/00-index.md)
- SDK สำหรับ Agent: [ENG-39](../docs/engineering-os/00-index.md)

*ส่วนหนึ่งของ GOFLOW Enterprise AI OS Master Package v4.0*