สร้างด้วย DXRating

เพลง ชาร์ต และเลเวลภายในของ maimai DX สำหรับผู้ช่วย AI และโค้ดของคุณเอง

เซิร์ฟเวอร์ MCP

เชื่อมต่อ Claude, ChatGPT, Cursor หรือไคลเอนต์ MCP ใดก็ได้ ค้นหาเพลง ดูชาร์ต และคำนวณเรตติ้งได้โดยไม่ต้องเขียนโค้ด

URL เซิร์ฟเวอร์

https://mcp.dxrating.net/mcp

ตั้งค่า MCP

REST API

เริ่มจาก dxdata: ทุกเพลง ชาร์ต เลเวลภายใน แท็ก และชื่อเรียก อยู่ในเอกสาร JSON เดียวที่แคชได้ ไม่ต้องมีบัญชีหรือ API key

เริ่มที่นี่

https://miruku.dxrating.net/api/v1/dxdata

เอกสาร API OpenAPI บันทึกการเปลี่ยนแปลง llms.txt

ข้อกำหนด

ข้อมูล: ใช้ได้ฟรี รวมถึงเชิงพาณิชย์ ยินดีถ้าให้เครดิต ชื่อเพลง ภาพปก และชาร์ตเป็นของ SEGA และผู้ถือสิทธิ์ DXRating ไม่อ้างลิขสิทธิ์ใดๆ ในสิ่งเหล่านี้
ข้อความให้เครดิต: Data from DXRating (dxrating.net)
ขีดจำกัดการเรียกใช้: MCP: ประมาณ 300 คำขอต่อนาทีต่อไคลเอนต์ REST API: ไม่มีขีดจำกัดตายตัว แต่ควรแคชผลลัพธ์และตรวจสอบซ้ำด้วย If-None-Match โดย dxdata แท็ก ชื่อเรียก และร้านเกมจะส่ง ETag มาให้

ความเสถียรของ API

API v1 เสถียรแล้ว ถ้าคุณสร้างเครื่องมือ บอท หรือเว็บไซต์บนมัน นี่คือสิ่งที่คุณวางใจได้

ความเข้ากันได้: ภายใน v1 จะมีแต่การเพิ่มเท่านั้น: endpoint ใหม่ พารามิเตอร์เสริม ฟิลด์ในผลลัพธ์ และค่า enum ใหม่ ให้ข้ามฟิลด์และค่าที่ไม่รู้จัก การลบหรือเปลี่ยนชื่อสิ่งใด หรือเปลี่ยนชนิดหรือความหมาย ถือเป็นการเปลี่ยนแปลงที่ไม่เข้ากัน แต่การแก้ไขข้อมูล (เลเวลภายใน ชื่อเพลง วันที่ การมีในเซิร์ฟเวอร์) ไม่นับ
การเลิกใช้งาน: สิ่งที่เราจะเลิกใช้จะแจ้งล่วงหน้าอย่างน้อย 6 เดือน โดยประกาศในบันทึกการเปลี่ยนแปลง และผลลัพธ์จะมีเฮดเดอร์ Deprecation (RFC 9745) และ Sunset (RFC 8594) จนกว่าจะถูกนำออก
เวอร์ชันใหม่: การเปลี่ยนแปลงที่ไม่เข้ากันจะอยู่ในเวอร์ชันใหม่ที่ /api/v2 ส่วน v1 จะยังใช้งานได้อย่างน้อย 12 เดือนหลังจาก v2 เสถียร
ID ถาวร: ID เพลง (dsng_…) และ ID ชาร์ต (dsht_…) เป็นแบบถาวรและไม่ถูกนำกลับมาใช้ซ้ำ เพลงและชาร์ตที่ถูกนำออกจากเกมจะยังอยู่ในแคตตาล็อกโดยมีรายการ serverIds ว่าง ถ้าพบว่าสองรายการเป็นเพลงเดียวกัน จะเก็บไว้หนึ่ง ID และอีก ID จะไม่ถูกใช้ซ้ำ ส่วนการแยกรายการจะเก็บ ID เดิมไว้และเพิ่ม ID ใหม่ ทั้งสองกรณีจะประกาศในบันทึกการเปลี่ยนแปลง
ขอบเขต: ครอบคลุม: dxdata แท็ก ชื่อเรียก และร้านเกม ซึ่งไม่ต้องเข้าสู่ระบบ ส่วนชาร์ตยอดนิยมและภาพชาร์ตให้บริการเท่าที่ทำได้ endpoint ที่ต้องใช้บัญชี DXRating (ความคิดเห็น การติดแท็ก การส่งชื่อเรียก การนำเข้าสกอร์) มีไว้สำหรับแอปของ DXRating เองและอาจเปลี่ยนได้ทุกเมื่อ
รับการแจ้งเตือน: ติดตาม issue บันทึกการเปลี่ยนแปลงบน GitHub เพื่อรับอีเมลทุกครั้งที่มีฟิลด์ endpoint หรือการเลิกใช้งานใหม่ บันทึกการเปลี่ยนแปลง
ช่วยเหลือ: คำถาม บั๊ก และคำขอต่างๆ ส่งได้ที่ GitHub issues github.com/gekichumai/dxrating