CUSTOMER REST API v1.0 • OPENAPI 3.0.3 • CORS READY

คู่มือใช้งานระบบ API สำหรับลูกค้า (Manga & Anime)

เชื่อมต่อข้อมูลมังงะ (หน้าแรก, ค้นหา, หมวดหมู่, รายละเอียดตอน, ภาพหน้ากระดาษ) และอนิเมะ (หน้าแรก, ค้นหา, พากย์ไทย/ซับไทย, แนวเรื่อง, สตรีม HLS M3U8) ไปยังเว็บไซต์ แอปมือถือ หรือบอทของคุณได้ทันที ลิงก์รูปภาพและสตรีมทั้งหมดเป็น Absolute Proxy URL ที่รองรับ CORS ข้ามโดเมนเรียบร้อยแล้ว

OpenAPI 3.0 JSON (Import Postman)Health JSONทดลองยิง API ด้านล่าง
สถานะระบบ API
กำลังตรวจสอบ...
Base URL ของเซิร์ฟเวอร์นี้
https://demoapp.lnw-manga.com
API Key สำหรับทดสอบ (ถ้ามี)

ขั้นตอนใช้งานระบบมังงะ (3 Steps)

  1. ดึงรายการหรือค้นหา: GET /api/v1/manga/home หรือ /api/v1/manga/search?q=solo
  2. ดึงรายชื่อตอนจาก slug: GET /api/v1/manga/{slug}
  3. ดึงรูปทุกหน้าจาก chapterSlug: GET /api/v1/manga/chapters/{chapterSlug} แล้วนำ data.images[] ไปแสดงผลในแท็ก <img> ได้เลย

ขั้นตอนใช้งานระบบอนิเมะ (3 Steps)

  1. ดึงรายการหรือค้นหา: GET /api/v1/anime/home หรือ /api/v1/anime/search?q=...
  2. ดึงรายชื่อตอนและ epId: GET /api/v1/anime/{slug}
  3. แยกลิงก์สตรีม HLS: GET /api/v1/anime/stream/{epId} แล้วส่ง data.masterPlaylistUrl เข้า hls.js หรือ Player บนมือถือ

การยืนยันตัวตน, Cache & Rate Limit

  • ส่ง Key ได้ 3 แบบ: X-API-Key, Authorization: Bearer ..., หรือ ?api_key=
  • ระบบมี In-Memory Cache ลดภาระต้นทาง (ดู Header X-Cache) หากต้องการข้อมูลสดทันทีให้เติม ?fresh=1
  • ตรวจโควตาได้จาก Header X-RateLimit-Remaining และ X-RateLimit-Reset

รายการ API Endpoints ทั้งหมด (18)

ใช้ตรวจสอบความพร้อมของ API Gateway, เช็กว่าระบบบังคับใช้ API Key หรือเปิดแบบ Public อยู่, ดูโควตา Rate Limit และ Endpoint ที่รองรับทั้งหมด

Cache TTL: 0sAuth: Public
ทดสอบยิง API จริง (Live Playground)
GET https://demoapp.lnw-manga.com/api/v1/health
curl -s "https://demoapp.lnw-manga.com/api/v1/health"
ตัวอย่างผลลัพธ์ (Example Response)
{
  "success": true,
  "meta": {
    "version": "1.0.0",
    "requestId": "req_a1b2c3d4e5f6",
    "timestamp": "2026-11-16T05:00:00.000Z",
    "responseTimeMs": 2,
    "authMode": "open",
    "client": "public",
    "cache": "NONE"
  },
  "data": {
    "status": "healthy",
    "service": "FairyAnime & Manga Customer API",
    "version": "1.0.0",
    "authRequired": false,
    "rateLimit": { "limit": 120, "windowSec": 60 },
    "cache": { "size": 14, "maxEntries": 500 },
    "docsUrl": "https://demoapp.lnw-manga.com/api-docs",
    "openApiUrl": "https://demoapp.lnw-manga.com/api/v1/openapi.json"
  }
}

ตารางรหัสสถานะและข้อผิดพลาด (Error Codes)

HTTPError Codeความหมายวิธีแก้ไข
200OKสำเร็จ (Request succeeded)อ่านข้อมูลจากฟิลด์ data ใน JSON Response
400BAD_REQUEST / MISSING_QUERYพารามิเตอร์ไม่ถูกต้อง หรือลืมส่งคำค้นหา (?q=...)ตรวจสอบ query/path parameters ตามตารางพารามิเตอร์ของ Endpoint นั้น ๆ
401MISSING_API_KEYไม่ได้ส่ง API Key (เมื่อระบบเปิดโหมดบังคับใช้ Key)ใส่ Header X-API-Key, Authorization: Bearer <key> หรือ ?api_key=<key>
403INVALID_API_KEYAPI Key ไม่ถูกต้องหรือถูกเพิกถอนตรวจสอบ Key จาก .env (CUSTOMER_API_KEYS) หรือติดต่อผู้ดูแลระบบ
404NOT_FOUNDไม่พบมังงะ, ตอน, หรืออนิเมะตาม slug/epId ที่ระบุตรวจสอบ slug จาก Endpoint รายการหรือค้นหาก่อนเรียก Detail
429RATE_LIMIT_EXCEEDEDยิง Request เกินโควตาต่อช่วงเวลาที่กำหนดหน่วงเวลาตาม Header Retry-After หรือ X-RateLimit-Reset แล้วลองใหม่
500INTERNAL_ERROR / STREAM_EXTRACTION_FAILEDเกิดข้อผิดพลาดระหว่างดึงข้อมูลหรือแยกสตรีมจากต้นทางลองเรียกใหม่พร้อม ?fresh=1 หรือตรวจสอบ logs ฝั่งเซิร์ฟเวอร์

สำหรับเจ้าของระบบ: การออก API Key ให้ลูกค้า (.env.local)

หากปล่อยว่างไว้ ระบบจะเปิดโหมด Open Mode ให้ทดสอบได้ทันที เมื่อต้องการขายหรือจำกัดสิทธิ์เฉพาะลูกค้า ให้สร้างไฟล์ .env.local ที่รูทโปรเจกต์แล้วระบุคีย์ลูกค้า:

# รูปแบบ: KEY1:ชื่อลูกค้า1,KEY2:ชื่อลูกค้า2
CUSTOMER_API_KEYS="fa_live_vip01:CustomerA,fa_live_app02:CustomerB"
API_REQUIRE_AUTH=true
API_RATE_LIMIT_MAX=120
API_RATE_LIMIT_WINDOW_SEC=60
API_PUBLIC_URL=https://demoapp.lnw-manga.com

ตัวอย่างการใช้งานจริง: อ่านมังงะ + เล่นอนิเมะ HLS

รูปภาพใน data.images[] และสตรีมใน data.masterPlaylistUrl สามารถใช้บนโดเมนของลูกค้าได้โดยตรง (ไม่ต้องเขียน Proxy เองซ้ำ):

// 1) ดึงภาพหน้ามังงะ
const ch = await fetch('https://demoapp.lnw-manga.com/api/v1/manga/chapters/30y-prologue-ตอนที่-21', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
}).then(r => r.json());
// ch.data.images.forEach(src => render <img src={src} />)

// 2) เล่นสตรีมอนิเมะด้วย hls.js
const stream = await fetch('https://demoapp.lnw-manga.com/api/v1/anime/stream/HC9Bz64p', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
}).then(r => r.json());
hls.loadSource(stream.data.masterPlaylistUrl);