API Tutorial

Base URL & Overview

Base URL (production): https://clip.dooapi.com

Local development: http://localhost:6020

API นี้ให้บริการข้อมูลคลิปวีดีโอ พร้อมค้นหา/กรอง และดูรายละเอียดทีละรายการ

Endpoints

GET /api/health ตรวจสอบสถานะ
GET /api/clips ค้นหาและแบ่งหน้า
GET /api/clips/:id ดูรายละเอียด
POST /api/clips เพิ่มข้อมูล (ต้องเป็นแอดมิน)

Response Structure

รายการ:

{
  "meta": { "page": 1, "limit": 20, "total": 100 },
  "data": [ { /* clip */ }, ... ]
}

รายละเอียด:

{ "data": { /* clip */ } }

คำอธิบายฟิลด์ข้อมูล

id เลขไอดี
title ชื่อคลิป (บังคับ)
iframe_url URL player iframe (บังคับ)
cover_url URL ภาพปก (อาจว่าง ถ้าไม่อัพโหลดและไม่เข้าเงื่อนไข tiktik3/4)
actor ชื่อนักแสดง (ข้ามได้)
studio ค่าย (ข้ามได้)
platform แพลตฟอร์ม (เลือกจาก: facebook, ig, JAV, JAVJAV, JAVJAVJAV, mlive, onlyfans, THlive, tiktok, twitter, VK, คลิปหลุด, ช้างไลฟ์, ทวิต)
notes หมายเหตุ
created_at วันที่บันทึก

ตัวอย่างการใช้งาน

ค้นหาจากชื่อคลิป และกรองแพลตฟอร์ม:

GET /api/clips?q=abc&platform=twitter&page=1&limit=20

เรียกดูรายละเอียด:

GET /api/clips/123

เพิ่มข้อมูล (ต้องล็อกอิน admin ที่เว็บก่อน หรือส่งผ่าน session จากเบราว์เซอร์):

POST /api/clips
Content-Type: application/json
{
  "title": "ตัวอย่างคลิป",
  "iframe_url": "https://tiktik4.nnnk2.com/play/1c655f137a9ab44808dcf4c538635006",
  "actor": "sample",
  "studio": "S1",
  "platform": "tiktok",
  "notes": "demo"
}

หมายเหตุ: ถ้าไม่ส่ง cover_url ระบบจะลองสร้างจากกติกา tiktik3/tiktik4 อัตโนมัติ

การจัดการข้อผิดพลาด

400 Bad Request — ข้อมูลไม่ครบ เช่น title/iframe_url
401 Unauthorized — ยังไม่ล็อกอิน admin (เฉพาะ POST)
404 Not Found — ไม่พบรายการ
500 Server Error — ผิดพลาดภายในระบบ