⚙️ API SERVICE & SANDBOX · v3.0

คู่มือเชื่อมต่อ APIBALLSOD Football API

เอกสารคู่มือการเชื่อมต่อสำหรับลูกค้าที่เช่า API บอลสด เพื่อนำข้อมูลสกอร์สด ตารางบอล ตารางคะแนน และลิงก์สตรีมส่วนตัว (.m3u8) ไปแสดงบนหน้าเว็บไซต์ของคุณผ่าน https://apiballsod.com

🌐 IP ของคุณ (ใช้สำหรับแจ้ง Whitelist Server IP)

กำลังตรวจสอบ...

🚀 ขอเปิด API Key (@mister_brunox)

Base URL & การแนบ API Key ยืนยันตัวตน

ทุกคำขอของลูกค้าที่เช่า API จะเชื่อมต่อผ่านเกตเวย์ความเร็วสูงของ APIBALLSOD.COM โดยตรง สามารถเลือกใช้ทั้งโดเมนหลักหรือซับโดเมน API ได้ตามต้องการ:

Primary Gatewayhttps://apiballsod.com/api

Dedicated Subdomain Gatewayhttps://api.apiballsod.com/api

🔑 วิธีที่ 1: แนบ HTTP Header (แนะนำสำหรับ JSON API)

เหมาะสำหรับเรียกผ่าน Backend Server หรือ Fetch / Axios ดึงข้อมูลสกอร์และตารางบอล

x-api-key: kl_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

📺 วิธีที่ 2: แนบ Query Parameter (สำหรับลิงก์สตรีม .m3u8)

สำหรับตัวเล่นวิดีโอบนหน้าเว็บ ให้แนบ ?key=YOUR_API_KEY ไว้ท้ายลิงก์สตรีมเสมอ เพื่อให้เปิดรับชมได้ครบทั้งบนคอมพิวเตอร์และมือถือ

https://apiballsod.com/api/stream/994821/playlist.m3u8?key=YOUR_API_KEY

Live API Sandbox — ทดสอบคีย์ของคุณแบบเรียลไทม์

วางรหัส kl_... ที่ได้รับจากแอดมินเพื่อทดสอบเรียกดูผลลัพธ์ JSON จริงจากเซิร์ฟเวอร์ทันที (หากยังไม่มีคีย์ คลิกทัก @mister_brunox เพื่อขอเช่าคีย์)

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

GET/api/matchesตารางบอล & ลิงก์ดูบอลสด

ดึงรายการแข่งขันฟุตบอลทั้งหมด สกอร์สด เวลาแข่ง โลโก้ทีม และลิงก์ stream_url (.m3u8) พร้อมเล่น

Query Params: status=ALL|LIVE|UPCOMING|FINISHED, sport=1

curl -H "x-api-key: YOUR_API_KEY" "https://apiballsod.com/api/matches?status=LIVE"

GET/api/matches/{id}รายละเอียดรายคู่

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

curl -H "x-api-key: YOUR_API_KEY" "https://apiballsod.com/api/matches/994821"

GET/api/matches/live-scoresสกอร์สดความเร็วสูง

Payload ขนาดเบาพิเศษสำหรับทำระบบ Polling อัปเดตตัวเลขสกอร์และนาทีแข่งขันทุกๆ 5-10 วินาที

curl -H "x-api-key: YOUR_API_KEY" "https://apiballsod.com/api/matches/live-scores"

GET/api/channelsเฉพาะลูกค้าที่มี API Key

ดึงรายชื่อช่องรายการสดทั้งหมดพร้อมโลโก้ หมวดหมู่ และ hls_url ส่วนตัว (ต้องแนบ API Key ที่เปิดสิทธิ์สตรีมแล้วเท่านั้น)

Query Params: category (optional)

curl -H "x-api-key: YOUR_API_KEY" "https://apiballsod.com/api/channels"

GET/api/standingsตารางคะแนนลีกดัง

ดึงตารางคะแนนอัปเดตอัตโนมัติ (PL = พรีเมียร์ลีก, LL = ลาลีกา, SA = เซเรียอา, BL = บุนเดสลีกา, TL = ไทยลีก 1)

Query Params: league=PL|LL|SA|BL|FL1|TL

curl -H "x-api-key: YOUR_API_KEY" "https://apiballsod.com/api/standings?league=PL"

GET/api/stream/{matchId}/playlist.m3u8ลิงก์สตรีมรายคู่ (Private Key)

ลิงก์สตรีมถ่ายทอดสดคู่ฟุตบอลตามรหัส matchId สำหรับใส่ใน Video Player หน้าเว็บ (แนบ ?key=YOUR_API_KEY)

Query Params: key=YOUR_API_KEY (Required)

https://apiballsod.com/api/stream/994821/playlist.m3u8?key=YOUR_API_KEY

GET/api/stream/channel/{slug}/playlist.m3u8ลิงก์สตรีมช่องสด (Private Key)

ลิงก์สตรีมช่องรายการสดตลอด 24 ชม. ตามรหัส slug ที่ได้รับจาก /api/channels (ต้องแนบ ?key=YOUR_API_KEY เสมอ)

Query Params: key=YOUR_API_KEY (Required)

https://apiballsod.com/api/stream/channel/{channel_slug}/playlist.m3u8?key=YOUR_API_KEY

ตัวอย่างโค้ดติดตัวเล่นวิดีโอ (HTML5 + Hls.js) บนหน้าเว็บของคุณ

คัดลอกตัวอย่างโค้ดด้านล่างไปวางในหน้าเว็บไซต์ของคุณ แล้วเปลี่ยน YOUR_API_KEY เป็นคีย์ที่ได้รับจากแอดมิน ก็สามารถเปิดเล่นถ่ายทอดสดได้ทันทีทั้งบนคอมพิวเตอร์และมือถือ:

HTML5 + Hls.js Production Snippet

<video id="apiballsod-player" controls autoplay playsinline style="width:100%;max-width:960px;aspect-ratio:16/9;background:#0f1420;"></video>
<script src="https://cdn.jsdelivr.net/npm/hls.js@1"></script>
<script>
  const video = document.getElementById('apiballsod-player');
  const streamUrl = 'https://apiballsod.com/api/stream/994821/playlist.m3u8?key=YOUR_API_KEY';

  if (Hls.isSupported()) {
    const hls = new Hls({
      maxBufferLength: 60,
      liveSyncDurationCount: 3
    });
    hls.loadSource(streamUrl);
    hls.attachMedia(video);
  } else if (video.canPlayType('application/vnd.apple.mpegurl')) {
    // รองรับการเปิดเล่นบนมือถือ iPhone / iPad (Safari) อัตโนมัติ
    video.src = streamUrl;
  }
</script>

เครื่องมือดึงรายการช่องสตรีม & สร้างไฟล์ .M3U (เฉพาะผู้มี API Key)

รายการช่องสตรีมสดและลิงก์สัญญาณภาพทั้งหมดสงวนสิทธิ์เฉพาะลูกค้าที่เช่าแพ็กเกจ API แล้วเท่านั้น (ไม่แสดงข้อมูลแบบสาธารณะ) กรุณากรอกรหัส kl_... ของคุณด้านล่างเพื่อยืนยันสิทธิ์และดึงรายการช่องพร้อมลิงก์ .m3u8

🔒

ข้อมูลรายการช่องถูกล็อกไว้สำหรับลูกค้าที่เช่า API เท่านั้น

วางรหัส API Key ที่ได้รับจากแอดมินแล้วกดยืนยันเพื่อดูรหัส Slug และคัดลอกลิงก์สตรีมส่วนตัว หรือติดต่อเช่าคีย์ใหม่ได้ที่ @mister_brunox