Xây dựng cùng DXRating

Bài hát, chart và internal level maimai DX, cho trợ lý AI và code của riêng bạn.

MCP server

Kết nối Claude, ChatGPT, Cursor hoặc bất kỳ MCP client nào. Tìm bài hát, tra chart và tính rating, không cần viết code.

URL server

https://mcp.dxrating.net/mcp

REST API

Bắt đầu với dxdata: mọi bài hát, chart, internal level, tag và tên gọi khác trong một tài liệu JSON có thể cache. Không cần tài khoản hay API key.

Bắt đầu tại đây

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

Tài liệu API OpenAPI Nhật ký thay đổi llms.txt

Điều khoản

Dữ liệu: Dùng miễn phí, kể cả cho mục đích thương mại. Rất cảm ơn nếu bạn ghi nguồn. Tên bài hát, ảnh bìa và chart thuộc về SEGA và các bên giữ bản quyền; DXRating không nhận bản quyền với chúng.
Dòng ghi nguồn: Data from DXRating (dxrating.net)
Giới hạn tần suất: MCP: khoảng 300 request mỗi phút cho mỗi client. REST API: không có giới hạn cứng, nhưng hãy cache phản hồi và xác thực lại bằng If-None-Match. dxdata, tag, tên gọi khác và địa điểm arcade đều gửi ETag.

Độ ổn định của API

API v1 đã ổn định. Nếu bạn xây công cụ, bot hay trang web trên nó, đây là những gì bạn có thể tin cậy.

Tương thích: Trong v1, thay đổi chỉ mang tính bổ sung: endpoint mới, tham số tùy chọn, trường phản hồi và giá trị enum. Hãy bỏ qua các trường và giá trị bạn không nhận ra. Xóa hoặc đổi tên bất cứ thứ gì, hay đổi kiểu hoặc ý nghĩa, đều được xem là thay đổi phá vỡ. Sửa dữ liệu (internal level, tên bài, ngày, khả dụng theo server) thì không.
Ngừng hỗ trợ: Mọi thứ bị ngừng hỗ trợ đều được báo trước ít nhất 6 tháng. Thông báo có trong nhật ký thay đổi, và phản hồi sẽ kèm header Deprecation (RFC 9745) và Sunset (RFC 8594) cho đến khi gỡ bỏ.
Phiên bản mới: Thay đổi phá vỡ sẽ nằm ở phiên bản mới tại /api/v2. v1 vẫn hoạt động ít nhất 12 tháng sau khi v2 ổn định.
ID ổn định: ID bài hát (dsng_…) và ID chart (dsht_…) là vĩnh viễn và không bao giờ được dùng lại. Bài hát và chart bị gỡ khỏi game vẫn ở trong danh mục với danh sách serverIds rỗng. Nếu hai mục hóa ra là cùng một bài, một ID được giữ lại và ID kia không bao giờ được dùng lại; khi tách, ID gốc được giữ và thêm một ID mới. Cả hai đều được thông báo trong nhật ký thay đổi.
Phạm vi: Được đảm bảo: dxdata, tag, tên gọi khác và arcade, không cần đăng nhập. Thịnh hành và ảnh chart chỉ ở mức cố gắng tốt nhất. Các endpoint cần tài khoản DXRating (bình luận, gắn tag, gửi tên gọi khác, nhập điểm) dành cho ứng dụng của chính DXRating và có thể thay đổi bất cứ lúc nào.
Nhận thông báo: Theo dõi issue nhật ký thay đổi trên GitHub để nhận email cho mỗi trường, endpoint mới và mỗi lần ngừng hỗ trợ. Nhật ký thay đổi
Hỗ trợ: Câu hỏi, lỗi và yêu cầu xin gửi qua GitHub issues. github.com/gekichumai/dxrating