ภาพรวม API

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

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

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

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

แอปของคุณ                        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

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

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

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

ดูวงจรชีวิตและ API Reference ที่เซสชันโทเค็น

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

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

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

# 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