# ภาพรวม API

DailyPlay มี API
ที่ช่วยให้**แอปพลิเคชันของบุคคลที่สาม**สามารถสร้างเซสชันเกมแบบใช้ครั้งเดียวสำหรับผู้ใช้ได้โดยอัตโนมัติ
เหมาะสำหรับ CRM, แพลตฟอร์มการตลาด, ระบบอีคอมเมิร์ซ หรือแอปพลิเคชันอื่นๆ ที่ต้องการให้ผู้ใช้เล่นเกม
DailyPlay อย่างมีการควบคุม

:::note[ต้องใช้แพ็กเกจ Business ขึ้นไป]
ฟีเจอร์ API ใช้ได้เฉพาะองค์กรที่มีแพ็กเกจ **Business**
ขึ้นไปเท่านั้น
:::

:::caution[กรุณาเปิดใช้ "Require API Session Token"]
ในการเปิดใช้เซสชันโทเค็น
คุณต้องเปิดการตั้งค่า**"Require API Session Token"**ในแท็บ**การตั้งค่า**ของแต่ละเกมหรือสตรีม
หากปิดการตั้งค่านี้ เกมจะเล่นได้โดยไม่มีข้อจำกัดของโทเค็น
:::

## วิธีการทำงาน

ขั้นตอนการเชื่อมต่อเป็นไปตามรูปแบบง่ายๆ:

1. **เซิร์ฟเวอร์ของคุณ**สร้างเซสชันโทเค็นแบบใช้ครั้งเดียวด้วย API Key
2. **แอปของคุณ**รีไดเรกต์ผู้ใช้ไปยัง URL เกมพร้อมโทเค็น
3. **DailyPlay** ตรวจสอบและใช้โทเค็น — ผู้ใช้เล่นได้ 1 ครั้ง
4. โทเค็นใช้แล้วทิ้ง ไม่สามารถนำกลับมาใช้ซ้ำ

```
แอปของคุณ                        DailyPlay
─────────                        ─────────
   │
   │  1. สร้างเซสชัน (x-api-key)
   ├─────────────────────────────────►  POST /api/org-api-keys/sessions
   │                                        │
   │  2. รับโทเค็นแบบใช้ครั้งเดียว         │
   ◄────────────────────────────────────────┘
   │
   │  3. รีไดเรกต์ผู้ใช้พร้อมโทเค็น
   ├─────────────────────────────────►  ผู้เล่นเปิด URL เกม
   │                                    ?session_token=<token>
   │
   │                                   4. ตรวจสอบและใช้โทเค็น
   │                                   5. ผู้ใช้เล่นเกม
   │                                   6. โทเค็นไม่สามารถใช้ซ้ำ
```

## แนวคิดหลัก

### API Keys

API Keys ใช้สำหรับยืนยันตัวตนเซิร์ฟเวอร์ของคุณเมื่อเรียกใช้ DailyPlay API แต่ละคีย์:

- สังกัดองค์กร
- สามารถกำหนดขอบเขตเฉพาะเกมหรือสตรีม
- ตั้งค่าขีดจำกัดอัตราได้
- เพิกถอนได้ทันที

ดูรายละเอียดการตั้งค่าและจัดการที่[API Keys](/th/api/api-keys/)

### เซสชันโทเค็น

เซสชันโทเค็นเป็นโทเค็นแบบใช้ครั้งเดียวที่อนุญาตให้เล่นได้ 1 ครั้ง:

- สร้างผ่าน API Key
- หมดอายุหลังระยะเวลาที่กำหนด (ค่าเริ่มต้น: 24 ชั่วโมง)
- ใช้ได้เพียงครั้งเดียว
- แนบ metadata สำหรับการติดตามได้

ดูวงจรชีวิตและ API Reference ที่[เซสชันโทเค็น](/th/api/session-tokens/)

## กรณีการใช้งาน

- **อีคอมเมิร์ซ**: ให้รางวัลลูกค้าด้วยการเล่นเกมหลังซื้อสินค้า
- **แคมเปญ CRM**: ส่งลิงก์เกมส่วนบุคคลไปยังกลุ่มเป้าหมาย
- **โปรแกรมสมาชิก**: มอบสิทธิ์เล่นเกมรายวันให้สมาชิก
- **การตลาดอีเวนต์**: แจกสิทธิ์เล่นเกมครั้งเดียวผ่านอีเวนต์หรือ QR Code

## ตัวอย่างด่วน

```bash
# 1. สร้างเซสชันโทเค็นจากเซิร์ฟเวอร์
curl -X POST https://app.dailyplay.ai/api/org-api-keys?action=create-session \
  -H "Content-Type: application/json" \
  -H "x-api-key: dpk_YOUR_API_KEY" \
  -d '{
    "game_id": 42,
    "external_ref": "user-12345",
    "expires_in_minutes": 60
  }'

# Response:
# {
#   "success": true,
#   "data": {
#     "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
#     "game_id": 42,
#     "expires_at": "2026-02-17T12:00:00.000Z"
#   }
# }

# 2. รีไดเรกต์ผู้ใช้ไปที่:
# หน้าเกมใน DailyPlay
# https://app.dailyplay.ai/game/42?session_token=a1b2c3d4-e5f6-7890-abcd-ef1234567890
#
# หน้าเกม iframe ไม่มี UI ของ DailyPlay
# https://app.dailyplay.ai/embed/42?session_token=a1b2c3d4-e5f6-7890-abcd-ef1234567890
#
# หน้าสตรีม
# https://app.dailyplay.ai/stream/<org-slug>/<stream_id>?session_token=a1b2c3d4-e5f6-7890-abcd-ef1234567890
```

## MCP สำหรับเอเจนต์ AI

API key เดียวกันสามารถขับเคลื่อนเซิร์ฟเวอร์ **MCP** ระยะไกลได้ ให้เอเจนต์ใน Cursor, Claude และไคลเอนต์อื่น สร้างเกม จัดการสตรีม สร้างสินทรัพย์ จัดการแกลเลอรีและบัตรกำนัล อ่านรายงาน และออกเซสชันได้ เปิดใช้ขอบเขตสิทธิ์ MCP บนคีย์ แล้วชี้ไคลเอนต์ไปที่ `https://app.dailyplay.ai/api/mcp`

ดู[เซิร์ฟเวอร์ MCP](/th/api/mcp/) และ[เอกสารอ้างอิงเครื่องมือ MCP](/th/api/mcp-tools/)

สำหรับความสามารถเดียวกันในแดชบอร์ด (ไม่ต้องใช้ API key) ดู[ผู้ช่วยในแอป](/th/assistant/overview/)

## ขั้นตอนต่อไป

- [สร้าง API Key](/th/api/api-keys/) จากแดชบอร์ด DailyPlay
- [เรียนรู้วงจรชีวิตของเซสชันโทเค็น](/th/api/session-tokens/)
- [เชื่อมต่อเอเจนต์ AI ผ่าน MCP](/th/api/mcp/)
- [ใช้ผู้ช่วยในแอป](/th/assistant/overview/)
- [ดู API Reference](/th/api/reference/)