API v1.5.0 พร้อมใช้งาน

คู่มือการใช้งานเชิงเทคนิค
ข้อมูลกีฬาครบวงจรระดับมืออาชีพ

เรียนรู้วิธีการเชื่อมต่อและดึงข้อมูลจากระบบโครงสร้างพื้นฐานของ LnwthaiLive เราเตรียม Endpoint ในรูปแบบ JSON ที่ออกแบบมาเพื่อความเร็วสูงสุดสำหรับเว็บสายกีฬาของคุณ ทั้งฟุตบอล มวยไทย มวยพักยก วัวชน และไก่ชน

การยืนยันตัวตนและความปลอดภัย

ทุกการเรียกใช้งาน API จำเป็นต้องระบุ API Key เพื่อยืนยันตัวตน คุณสามารถส่งคีย์ผ่าน HTTP Header ดังนี้:

x-api-key: YOUR_SECRET_KEY

หรือระบุผ่าน Query Parameter สำหรับการใช้งานที่ต้องการความรวดเร็ว เช่น ใน Video Player:

?api_key=YOUR_SECRET_KEY

Football Live Matches (ฟุตบอลสด)

GET/api/public/matches

รายการแมตช์วันนี้ทั้งหมด + สถานะสด

ทดสอบ Sandbox
GET/api/public/matches/live-incidents

ดึงข้อมูลเหตุการณ์สำคัญในการแข่งขันสดแบบกลุ่ม (เช่น ประตู, ใบเหลือง/แดง, เปลี่ยนตัว)

ทดสอบ Sandbox
GET/api/public/matches/[matchId]/details

ดึงรายละเอียด ข้อมูลสถิติ ไลน์อัพผู้เล่น และข้อมูลการวิเคราะห์ของแมตช์เดี่ยว

GET/api/streams/[id]

ดึงลิงก์สตรีมถ่ายทอดสดฟุตบอล (HLS m3u8)

GET/api/public/results

ผลฟุตบอลย้อนหลังและของวันนี้ทั้งหมด

ทดสอบ Sandbox

Statistics & Analysis (สถิติและวิเคราะห์)

GET/api/public/standings

ตารางคะแนนลีกหลัก (พรีเมียร์ลีก, ลาลีกา ฯลฯ)

ทดสอบ Sandbox
GET/api/analyse/today

บทวิเคราะห์บอลสดรายวันระดับ VIP

ทดสอบ Sandbox
GET/api/analyse/[id]

รายละเอียดสถิติเชิงลึกวิเคราะห์แบบ Real-time 14 ฟีเจอร์

Muay Thai & Muay Pakyok (มวยไทย & มวยพักยก)

GET/api/public/boxing

รายการมวยไทยและผลสด (สนามมวยหลักเช่น ราชดำเนิน, ลุมพินี, อ้อมน้อย)

ทดสอบ Sandbox
GET/api/public/muay-pakyok

มวยพักยกและอัตราต่อรองสด OneBX พร้อมลิงก์ดูสดระบบทีวี IPTV (HLS)

ทดสอบ Sandbox

Digital TV & IPTV (ทีวีดิจิตอล & IPTV)

GET/api/iptv/channels

ดึงรายชื่อช่อง IPTV ทั้งหมด แยกหมวดหมู่ พร้อมลิงก์สตรีมที่ผูกโทเค็นความปลอดภัย (stk)

ทดสอบ Sandbox
GET/api/iptv/stream/[channelId]

ดึง HLS stream (m3u8) ของช่องทีวีดิจิตอลที่ระบุ

Bullfighting & Cockfighting (วัวชน & ไก่ชน)

GET/api/public/wuachon

รายการถ่ายทอดสดวัวชน/ไก่ชน + ผลสด และลิงก์สตรีมเข้ารหัส Token

ทดสอบ Sandbox
GET/api/public/wuachon/stream

ดึงลิงก์ HLS (m3u8) วัวชน/ไก่ชน ที่ผ่านระบบ Proxy หลบเลี่ยงการบล็อกแล้ว

Multi-Sports (กีฬาอื่นๆ / GeSports)

GET/api/ge-sports

รายการบาสเกตบอล, เทนนิส, แบดมินตัน, กอล์ฟ และอื่นๆ ในวันปัจจุบัน

ทดสอบ Sandbox

คู่มือการเชื่อมต่อระบบถ่ายทอดสด & Live Streaming Player

ลิงก์สตรีมมิ่งที่ส่งคืนจากระบบ เช่น /api/iptv/stream/[channelId]?stk=... ได้รับการปกป้องเพื่อความปลอดภัยสูงสุด ผู้พัฒนาโปรแกรมควรทำความเข้าใจข้อกำหนดสำคัญดังนี้เพื่อหลีกเลี่ยงปัญหาในการเชื่อมต่อ:

⚠️ ข้อควรระวังสำคัญ: ระบบล็อก IP (IP-Binding) บน Token `stk`

เซสชันโทเค็น stk ที่คืนค่าจาก API จะทำการผูกมัดกับ IP แรกที่ดึงข้อมูลวิดีโอ (IP-Binding) ทันที โดยจำกัดให้เข้าถึงได้เฉพาะช่วง IP Subnet Class B เดียวกันเท่านั้นเพื่อความเสถียรบนเครือข่ายมือถือ

  • ปัญหาที่พบบ่อย (403 Forbidden): หากระบบหลังบ้าน (Backend Server) ของคุณทำการเรียกทดสอบ URL สตรีมมิ่ง หรือทำการส่ง Ping ไปเช็คความถูกต้องของลิงก์ m3u8 ก่อนส่งต่อไปที่หน้าเว็บ โทเค็นจะถูกผูกเข้ากับ IP ของเซิร์ฟเวอร์หลังบ้านทันที เมื่อนำลิงก์ดังกล่าวไปเล่นในเครื่องเล่นวิดีโอ (Video Player) ของผู้ใช้ปลายทาง จะทำให้ผู้ใช้ปลายทางเจอข้อผิดพลาด 403 Forbidden เนื่องจาก IP ไม่ตรงกัน
  • แนวทางปฏิบัติที่ถูกต้อง: ให้ดึงข้อมูล URL สตรีมมิ่งมาแล้วส่งต่อไปยังผู้ใช้ปลายทาง (Client Web/App Browser) เพื่อนำไปป้อนให้ Video Player (เช่น Video.js, Hls.js, Plyr, หรือเครื่องเล่นในแอพมือถือ) เป็นผู้เรียกโหลด m3u8 โดยตรงห้ามเซิร์ฟเวอร์หลังบ้านทำการ Fetch หรือส่ง Request เช็คลิงก์สตรีมมิ่งนั้นเด็ดขาด

🎥 ขั้นตอนการเล่นสตรีมมิ่งวัวชน & ไก่ชน (Wuachon Integration Flow)

ลิงก์สตรีมที่ได้จาก API วัวชน/ไก่ชนหลัก จะต้องทำการร้องขอเพื่อแปลงรหัสผ่าน API อีกหนึ่งขั้นตอนก่อนนำไปเล่นจริง:

  1. ทำการส่ง GET Request ไปยัง Endpoint สตรีมมิ่งของวัวชน เช่น:
    GET https://yourdomain.com/api/public/wuachon/stream?code=CH5&stk=YOUR_API_STREAM_TOKEN
  2. ระบบจะตอบกลับข้อมูลในรูปแบบ JSON โดยมีค่า streamUrl และสถานะ success: true:
    {
  "success": true,
  "streamUrl": "/api/wuachon/proxy?key=CH5_resolved",
  "streamKey": "CH5_resolved",
  "type": "hls"
}
  3. นำเอาค่าใน streamUrl ไปต่อท้ายโดเมนหลักของเซิร์ฟเวอร์คุณ เช่น https://yourdomain.com/api/wuachon/proxy?key=CH5_resolvedแล้วป้อนลิงก์นี้ให้กับเครื่องเล่นวิดีโอ (Video Player) เพื่อเริ่มเล่นการถ่ายทอดสดทันที

🛡️ การเชื่อมต่อบนแอพพลิเคชันมือถือ หรือ ระบบปิด (Internal / Mobile App Direct Connection)

หากการเชื่อมต่อของคุณทำงานอยู่ในสภาพแวดล้อมระบบปิด เช่น แอพพลิเคชันบนมือถือ (iOS/Android), Smart TV หรือระบบหลังบ้านที่มีการป้องกันความปลอดภัยอย่างดี และไม่ต้องกังวลเรื่องการถูกโจรกรรม API Key คุณสามารถเรียกสตรีมแบบไม่ต้องใช้ระบบเซสชัน IP-Binding ได้โดยเรียกผ่าน API Key โดยตรงใน Player:

https://yourdomain.com/api/iptv/stream/[channelId]?api_key=YOUR_SECRET_KEY

* วิธีนี้ช่วยลดขั้นตอนการดึงโทเค็นและขจัดปัญหา IP Mismatch ได้อย่างสมบูรณ์ แต่ผู้พัฒนาต้องเก็บรักษา API Key ในฝั่ง Client ไม่ให้ถูกถอดรหัสหรือเผยแพร่สู่สาธารณะ

คำถามที่พบบ่อย (FAQ)

ข้อมูลอัปเดตเร็วแค่ไหน?

ระบบของเราใช้ WebSocket และ Scraper ระดับสูง ข้อมูลผลบอลสดและอัตราต่อรองมวย/วัวชน อัปเดตแบบ Real-time ภายใน 5-10 วินาที

รองรับประเภทกีฬากี่แบบ?

เราครอบคลุมกีฬายอดนิยมอย่างฟุตบอล, มวยไทย (รวมมวยพักยก), วัวชน, ไก่ชน และกีฬาต่างประเทศอีกกว่า 15 ประเภท เช่น บาสเกตบอล เทนนิส แบดมินตัน ฯลฯ

ถ้าระบบสตรีมมิ่งมีปัญหาจะทำอย่างไร?

เรามีระบบ Fail-over และการทำ HLS Edge CDN ที่ช่วยกระจายโหลดและสลับแหล่งที่มาสำรองให้อัตโนมัติ พร้อมเจ้าหน้าที่ดูแล 24 ชม.

จำกัดการเรียกใช้งานหรือไม่?

ขึ้นอยู่กับแพ็กเกจที่คุณเลือก เริ่มต้นที่ 60 Requests/Minute ไปจนถึงแบบไม่จำกัด (Unlimited) สำหรับ Enterprise