ข้ามไปที่เนื้อหาหลัก

API ทำงานอย่างไร

บทความนี้อธิบายพื้นฐานของ LeagueRepublic API ด้วยภาษาที่เข้าใจง่าย คุณไม่จำเป็นต้องมีความรู้ด้านเทคนิคก็อ่านตามได้

เขียนโดย Pedro Maia

ใครใช้งานได้บ้าง

ลีกที่อยู่ในแผน ทอง (Gold) และเปิดใช้ API แล้ว หากต้องการเปิดใช้ ให้ไปที่ หน้าแรกผู้ดูแลระบบ > API > การตั้งค่า API แล้วติ๊ก เปิดใช้งาน JSON API หากขาดอย่างใดอย่างหนึ่ง ทุกที่อยู่เว็บในบทความเหล่านี้จะส่งข้อผิดพลาดกลับมาแทนข้อมูลของคุณ

มันคืออะไร

API ช่วยให้เว็บไซต์ แอป หรือโปรแกรมอื่นอ่านโปรแกรมการแข่งขัน ผลการแข่งขัน และตารางคะแนนของลีกคุณได้โดยตรงจาก LeagueRepublic ลองนึกภาพว่ามันเป็นพนักงานเสิร์ฟ: เว็บไซต์ของคุณขอบางอย่าง ("ขอการแข่งขันของวันนี้หน่อย") แล้ว LeagueRepublic ก็นำคำตอบกลับมาให้

ขอข้อมูลอย่างไร

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

JSON หน้าตาเป็นอย่างไร

เป็นรายการของป้ายกำกับและค่า คล้ายกับแบบฟอร์มที่กรอกแล้ว:

{ "homeTeamName": "Arthurlie", "homeScore": "2" }

คำที่อยู่หน้าเครื่องหมายทวิภาคคือ ชื่อฟิลด์ (ป้ายกำกับบนแบบฟอร์ม) ส่วนที่อยู่หลังคือ ค่า (สิ่งที่เขียนไว้ในช่อง) ข้อกำหนดของ API อธิบายว่าชื่อฟิลด์แต่ละชื่อหมายถึงอะไร

ID คืออะไร

ทุกลีก ฤดูกาล ดิวิชัน ทีม และการแข่งขันใน LeagueRepublic มีหมายเลขของตัวเองที่เรียกว่า ID ใช้งานเหมือนหมายเลขสมาชิก: ไม่มีวันเปลี่ยน และไม่มีสองสิ่งใดที่ใช้หมายเลขเดียวกัน คุณใส่ ID ลงในที่อยู่เว็บเพื่อระบุว่าต้องการฤดูกาลหรือทีมใด

ฉันจะหา ID ของฉันได้อย่างไร

ID ลีกของคุณ แสดงอยู่ที่ หน้าแรกผู้ดูแลระบบ > API > การตั้งค่า API

ID ฤดูกาลของคุณ: เปิดที่อยู่นี้ในเบราว์เซอร์ โดยใส่ ID ลีกของคุณแทน [ID-ลีกของฉัน] ระบบจะแสดงรายการฤดูกาลของคุณ พร้อม ID ของแต่ละฤดูกาล

https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-ลีกของฉัน].json

ID ของดิวิชันและทีม จะปรากฏในรายการที่ API ส่งกลับมา หากคุณใช้บทความ สร้าง… บทความใดบทความหนึ่ง ผู้ช่วย AI จะค้นหาให้คุณเอง

มีขีดจำกัดไหม

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

คำบางคำที่คุณจะได้เห็น

Road – ทีมเยือน LeagueRepublic ใช้คำว่า "road" ในที่ที่คนส่วนใหญ่ใช้คำว่า "ทีมเยือน"

นัดการแข่งขัน (fixture) – การแข่งขันหนึ่งนัด ไม่ว่าจะแข่งไปแล้วหรือยัง

กลุ่มการแข่งขัน (fixture group) – ดิวิชัน (เช่น "Premier Division") ถ้วย หรือกลุ่มการแข่งขันอื่น ๆ

ผลการแข่งขัน (result) – นัดการแข่งขันที่มีสกอร์แล้ว

null – ช่องนั้นว่าง ลีกไม่ได้กรอกไว้ หรือไม่เกี่ยวข้อง

true / false – ใช่ / ไม่ใช่

รายละเอียดทั้งหมดอยู่ที่ไหน

ทุกอย่างที่แน่นอน เช่น ชื่อฟิลด์ทุกชื่อ ขีดจำกัด และข้อความแสดงข้อผิดพลาด อยู่ในข้อกำหนดของ API:

นี่ไม่ใช่คำตอบที่ต้องการใช่ไหม