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

วิธีการทำงานของ API

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

เขียนโดย Pedro Maia

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

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

API คืออะไร

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

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

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

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

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

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

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

ID คืออะไร

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

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

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

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

https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json

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

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

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

คำศัพท์ที่คุณจะเจอ

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

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

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

Result – นัดการแข่งขันที่มีสกอร์

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

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

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

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

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