ScoreBat
เครื่องมือนักพัฒนา

API วิดีโอฟุตบอลอย่างเป็นทางการ

เริ่มต้นอย่างรวดเร็ว

  1. รับโทเค็นสำหรับเข้าใช้งานจาก แท็บการเข้าถึง
  2. เรียกใช้ Endpoint ของ API ตัวใดตัวหนึ่ง เช่น:
    GET
  3. แยกวิเคราะห์การตอบกลับ JSON
  4. นำ HTML embed ของวิดีโอรายการหนึ่งจากการตอบกลับไปใส่ในหน้าเว็บเพื่อแสดงโปรแกรมเล่น สำหรับแอปมือถือ คุณสามารถแสดงวิดีโอใน webview ได้โดยแยก URL ของวิดีโอออกจากโค้ดฝัง

โทเค็นสำหรับเข้าใช้งาน

คุณต้องมีโทเค็นสำหรับเข้าถึง API จึงจะใช้ Video API ได้

ทุกคำขอต้องใส่โทเค็นสำหรับเข้าใช้งานเป็นพารามิเตอร์ token ใน URL ของคำขอ

คุณสามารถรับโทเค็นสำหรับเข้าใช้งานได้ใน แท็บการเข้าถึง

Endpoint

คุณสามารถดึงโค้ดฝังของวิดีโอในรูปแบบ JSON ได้จาก Endpoint ต่อไปนี้:

Free Feed

GET

Endpoint Free Feed ให้คุณเข้าถึงไฮไลต์การแข่งขันได้แบบจำกัด โดยครอบคลุมลีกที่คัดเลือกและแมตช์เก่า เพื่อให้ทดลองดูความสามารถของ Video API เวอร์ชันเต็ม

  • ครอบคลุมเพียงบางลีกและการแข่งขัน โดยมักเป็นแมตช์เก่าหรือไฮไลต์ที่คัดเลือกไว้
  • ส่งวิดีโออย่างเป็นทางการที่ฝังได้จากแหล่งที่ผ่านการยืนยัน
  • เหมาะสำหรับการทดสอบ
  • ไม่ครอบคลุมการแข่งขันทั้งหมดหรือข้อมูลสดที่มีในแพ็กเกจแบบชำระเงิน

Featured Feed

GET

ส่งฟีดที่คัดสรรให้มีความเกี่ยวข้อง โดยรวมทั้งแมตช์ล่าสุดและแมตช์สำคัญจากลีกและการแข่งขันฟุตบอลชั้นนำ ฟีดนี้เน้นเกมยอดนิยมและน่าสนใจ แต่ไม่ได้รวมทุกแมตช์ หากต้องการเข้าถึงวิดีโอทั้งหมดของลีกหรือทีมที่ระบุ ให้ใช้ Endpoint สำหรับการแข่งขันหรือทีม

  • รวมแมตช์ล่าสุดที่คัดเลือกจากหลายลีก
  • ไม่รวมทุกแมตช์หรือการแข่งขัน โดยแสดงเฉพาะรายการที่เกี่ยวข้องมากที่สุด
  • ใช้ได้กับแพ็กเกจแบบชำระเงินทุกแพ็กเกจ

การแข่งขัน

GET

คุณสามารถเรียกดูวิดีโอของการแข่งขันใดก็ได้ผ่าน Endpoint การแข่งขัน โดย Endpoint นี้จะส่งวิดีโอจากแมตช์ล่าสุดของการแข่งขันที่ระบุ

ตัวอย่างเช่น URL ด้านล่างจะส่งวิดีโอจากแมตช์ล่าสุดของ Premier League โดยข้อความ england-premier-league คือรหัสเฉพาะ (ID) ของ Premier League

ตัวอย่าง ID ของการแข่งขันยอดนิยม:

พรีเมียร์ลีก
เซเรีย อา
ลาลีกา
บุนเดสลีกา
ลีกเอิง

ดูรายการ ID ของการแข่งขันทั้งหมดได้ที่ นี่

ทีม

GET

คุณสามารถเรียกดูวิดีโอของทีมใดก็ได้ผ่าน Endpoint ทีม โดย Endpoint นี้จะส่งวิดีโอจากแมตช์ล่าสุดของทีมที่ระบุ

ตัวอย่างเช่น URL ด้านล่างจะส่งวิดีโอจากแมตช์ล่าสุดของ Real Madrid โดยข้อความ real-madrid คือรหัสเฉพาะ (ID) ของ Real Madrid

ตัวอย่าง ID ของทีมยอดนิยม:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

ดูรายการ ID ของทีมทั้งหมดได้ที่ นี่

การถ่ายทอดสด

GET

ส่งเฉพาะการแข่งขันที่มีการถ่ายทอดสดอย่างเป็นทางการ ทั้งแมตช์ที่กำลังแข่งขันและแมตช์ที่จบแล้ว รายการจะเริ่มปรากฏประมาณ 5 นาทีก่อนเริ่มการแข่งขัน

  • แสดงเฉพาะการแข่งขันที่มีสตรีมอย่างเป็นทางการและสามารถฝังได้
  • รวมแมตช์ที่กำลังแข่งขันและเพิ่งจบ พร้อมวิดีโอย้อนหลังเมื่อมีให้บริการ
  • รายการจะเริ่มปรากฏประมาณ 5 นาทีก่อนเวลาเริ่มการแข่งขันตามกำหนด

Endpoint ที่อัปเดต

GET

Endpoint นี้ช่วยตรวจสอบว่าฟีดของการแข่งขันหรือทีมใดเพิ่งได้รับการอัปเดต จึงไม่ต้องส่งคำขอตรวจสอบ Endpoint ทุกตัวแยกกัน

โครงสร้างการตอบกลับ

การตอบกลับเป็นออบเจ็กต์ JSON ที่มีคีย์ response ซึ่งเก็บอาร์เรย์ของออบเจ็กต์การแข่งขัน แต่ละแมตช์ประกอบด้วยข้อมูลพื้นฐาน รายละเอียดการแข่งขันที่เกี่ยวข้อง และรายการวิดีโอที่มีให้บริการ

JSON
{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","homeTeam": {"name": "Chelsea","slug": "chelsea","id": 229},"awayTeam": {"name": "Manchester United","slug": "manchester-united","id": 243},"videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}

คีย์ response มีอาร์เรย์ของออบเจ็กต์การแข่งขัน แต่ละออบเจ็กต์แทนการแข่งขันฟุตบอลหนึ่งแมตช์และมีฟิลด์ต่อไปนี้:

  • title – ชื่อการแข่งขัน (เช่น Chelsea - Manchester United)
  • competition – ชื่อรายการแข่งขัน (เช่น England Premier League)
  • date – วันที่และเวลาเริ่มการแข่งขัน
  • thumbnail – URL ของภาพขนาดย่อสำหรับการแข่งขัน
  • videos – อาร์เรย์ของวิดีโอทั้งหมดที่มีสำหรับการแข่งขัน แต่ละออบเจ็กต์วิดีโอประกอบด้วย:
    • title – ชื่อวิดีโอ (เช่น Highlights หรือ Extended Highlights)
    • embed – โค้ด HTML สำหรับฝังวิดีโอ
    • id – รหัสเฉพาะของวิดีโอ
  • homeTeam / awayTeam – ออบเจ็กต์ที่แสดงทีมซึ่งเข้าร่วมการแข่งขัน ประกอบด้วย:
    • name – ชื่อเต็มของทีม (เช่น Chelsea)
    • slug – Slug ของทีมที่ใช้ใน URL (เช่น chelsea)
    • id – รหัสเฉพาะของทีม
  • matchviewUrl – URL ของหน้าวิดเจ็ตมุมมองการแข่งขัน ซึ่งมีข้อมูลโดยละเอียด เช่น ผลบอลสด สถิติ และตารางอันดับ
  • competitionUrl – URL ของวิดเจ็ตการแข่งขัน ซึ่งแสดงตารางคะแนนสด ผลการแข่งขัน และโปรแกรมที่กำลังจะมาถึง

เล่นอัตโนมัติ

เปิดเล่นอัตโนมัติได้โดยเพิ่มพารามิเตอร์ autoplay=1 ลงใน URL ของวิดีโอ

ตัวอย่าง:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1หากใช้ HTML embed โดยตรง คุณสามารถเพิ่ม &autoplay=1 ต่อท้าย URL ของวิดีโอภายใน src ของ iframe

โควตา

แต่ละแพ็กเกจมีขีดจำกัดคำขอต่อเดือน

  • การรับชมวิดีโอหรือแสดงวิดเจ็ตแต่ละครั้งนับเป็น 1 request
  • การเรียก Video API แต่ละครั้งนับเป็น 5 requests ในโควตารายเดือน

ตัวอย่าง:

  • Starter plan รวมคำขอ 5,000 ครั้งต่อเดือน
  • Standard plan รวมคำขอ 20,000 ครั้งต่อเดือน
  • Advanced plan รวมคำขอ 100,000 ครั้งต่อเดือน
  • หากต้องการขีดจำกัดที่สูงขึ้น โปรด ติดต่อเรา เพื่อดู Enterprise plans

หากใช้คำขอเกินขีดจำกัดรายเดือน บัญชีของคุณจะเปลี่ยนเป็น Free plan โดยอัตโนมัติจนถึงรอบบิลถัดไป ระหว่างนั้น วิดเจ็ตและวิดีโอจะแสดงโฆษณาและโลโก้ ScoreBat และจะเข้าถึงได้เฉพาะ Endpoint Free Feed