CUSTOMER REST API v1.0 • OPENAPI 3.0.3 • CORS READY
คู่มือใช้งานระบบ API สำหรับลูกค้า (Manga & Anime)
เชื่อมต่อข้อมูลมังงะ (หน้าแรก, ค้นหา, หมวดหมู่, รายละเอียดตอน, ภาพหน้ากระดาษ) และอนิเมะ (หน้าแรก, ค้นหา, พากย์ไทย/ซับไทย, แนวเรื่อง, สตรีม HLS M3U8) ไปยังเว็บไซต์ แอปมือถือ หรือบอทของคุณได้ทันที ลิงก์รูปภาพและสตรีมทั้งหมดเป็น Absolute Proxy URL ที่รองรับ CORS ข้ามโดเมนเรียบร้อยแล้ว
สถานะระบบ API
กำลังตรวจสอบ...
Base URL ของเซิร์ฟเวอร์นี้
https://demoapp.lnw-manga.comAPI Key สำหรับทดสอบ (ถ้ามี)
ขั้นตอนใช้งานระบบมังงะ (3 Steps)
- ดึงรายการหรือค้นหา:
GET /api/v1/manga/homeหรือ/api/v1/manga/search?q=solo - ดึงรายชื่อตอนจาก
slug:GET /api/v1/manga/{slug} - ดึงรูปทุกหน้าจาก
chapterSlug:GET /api/v1/manga/chapters/{chapterSlug}แล้วนำdata.images[]ไปแสดงผลในแท็ก<img>ได้เลย
ขั้นตอนใช้งานระบบอนิเมะ (3 Steps)
- ดึงรายการหรือค้นหา:
GET /api/v1/anime/homeหรือ/api/v1/anime/search?q=... - ดึงรายชื่อตอนและ
epId:GET /api/v1/anime/{slug} - แยกลิงก์สตรีม 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
ตารางรหัสสถานะและข้อผิดพลาด (Error Codes)
| HTTP | Error Code | ความหมาย | วิธีแก้ไข |
|---|---|---|---|
| 200 | OK | สำเร็จ (Request succeeded) | อ่านข้อมูลจากฟิลด์ data ใน JSON Response |
| 400 | BAD_REQUEST / MISSING_QUERY | พารามิเตอร์ไม่ถูกต้อง หรือลืมส่งคำค้นหา (?q=...) | ตรวจสอบ query/path parameters ตามตารางพารามิเตอร์ของ Endpoint นั้น ๆ |
| 401 | MISSING_API_KEY | ไม่ได้ส่ง API Key (เมื่อระบบเปิดโหมดบังคับใช้ Key) | ใส่ Header X-API-Key, Authorization: Bearer <key> หรือ ?api_key=<key> |
| 403 | INVALID_API_KEY | API Key ไม่ถูกต้องหรือถูกเพิกถอน | ตรวจสอบ Key จาก .env (CUSTOMER_API_KEYS) หรือติดต่อผู้ดูแลระบบ |
| 404 | NOT_FOUND | ไม่พบมังงะ, ตอน, หรืออนิเมะตาม slug/epId ที่ระบุ | ตรวจสอบ slug จาก Endpoint รายการหรือค้นหาก่อนเรียก Detail |
| 429 | RATE_LIMIT_EXCEEDED | ยิง Request เกินโควตาต่อช่วงเวลาที่กำหนด | หน่วงเวลาตาม Header Retry-After หรือ X-RateLimit-Reset แล้วลองใหม่ |
| 500 | INTERNAL_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);