DXRating ဖြင့် တည်ဆောက်ပါ

AI assistant များနှင့် သင့်ကိုယ်ပိုင် code အတွက် maimai DX သီချင်း၊ chart နှင့် internal level များ။

MCP server

Claude၊ ChatGPT၊ Cursor သို့မဟုတ် မည်သည့် MCP client နှင့်မဆို ချိတ်ဆက်ပါ။ သီချင်းရှာခြင်း၊ chart ကြည့်ခြင်းနှင့် rating တွက်ခြင်းကို code မလိုဘဲ လုပ်နိုင်သည်။

Server URL

https://mcp.dxrating.net/mcp

MCP သတ်မှတ်ရန်

REST API

dxdata ဖြင့် စတင်ပါ: သီချင်း၊ chart၊ internal level၊ tag နှင့် alias အားလုံးကို cache လုပ်နိုင်သော JSON document တစ်ခုတည်းတွင် ရရှိနိုင်သည်။ အကောင့် သို့မဟုတ် API key မလိုပါ။

ဤနေရာမှ စတင်ပါ

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

API docs OpenAPI Changelog llms.txt

စည်းကမ်းချက်များ

ဒေတာ: စီးပွားဖြစ်အပါအဝင် အခမဲ့ အသုံးပြုနိုင်သည်။ Credit ပေးလျှင် ကျေးဇူးတင်ပါသည်။ သီချင်းအမည်၊ artwork နှင့် chart များသည် SEGA နှင့် ၎င်းတို့၏ မူပိုင်ရှင်များ ပိုင်ဆိုင်ပြီး DXRating က ၎င်းတို့အပေါ် မူပိုင်ခွင့် မတောင်းဆိုပါ။
Credit စာကြောင်း: Data from DXRating (dxrating.net)
Rate limit များ: MCP: client တစ်ခုလျှင် တစ်မိနစ်ကို request 300 ခန့်။ REST API: တင်းကျပ်သော ကန့်သတ်ချက် မရှိသော်လည်း response များကို cache လုပ်ပြီး If-None-Match ဖြင့် revalidate လုပ်ပါ။ dxdata၊ tag၊ alias နှင့် arcade venue များသည် ETag ပို့ပါသည်။

API တည်ငြိမ်မှု

API v1 သည် တည်ငြိမ်ပါသည်။ ၎င်းပေါ်တွင် tool၊ bot သို့မဟုတ် ဆိုက် တည်ဆောက်ပါက အောက်ပါအချက်များကို အားကိုးနိုင်ပါသည်။

လိုက်ဖက်ညီမှု: v1 အတွင်း ပြောင်းလဲမှုများသည် ထပ်ဖြည့်ခြင်းသာ ဖြစ်သည်: endpoint အသစ်၊ optional parameter၊ response field နှင့် enum တန်ဖိုးများ။ မသိသော field နှင့် တန်ဖိုးများကို လျစ်လျူရှုပါ။ တစ်ခုခုကို ဖယ်ရှားခြင်း၊ အမည်ပြောင်းခြင်း သို့မဟုတ် type သို့မဟုတ် အဓိပ္ပာယ် ပြောင်းခြင်းကို breaking change ဟု သတ်မှတ်သည်။ ဒေတာ ပြင်ဆင်ခြင်း (internal level၊ အမည်၊ ရက်စွဲ၊ server ရရှိနိုင်မှု) သည် breaking change မဟုတ်ပါ။
Deprecation: ကျွန်ုပ်တို့ ရပ်ဆိုင်းမည့်အရာမှန်သမျှကို အနည်းဆုံး 6 လ ကြိုတင် အသိပေးပါမည်။ Changelog တွင် ကြေညာပြီး မဖယ်ရှားမီအထိ response များတွင် Deprecation (RFC 9745) နှင့် Sunset (RFC 8594) header များ ပါဝင်ပါမည်။
Version အသစ်များ: Breaking change များကို /api/v2 တွင် version အသစ်အဖြစ် ထုတ်ပါမည်။ v2 တည်ငြိမ်ပြီးနောက် အနည်းဆုံး 12 လ v1 ဆက်အလုပ်လုပ်ပါမည်။
တည်ငြိမ်သော ID များ: Song ID (dsng_…) နှင့် sheet ID (dsht_…) များသည် အမြဲတမ်းဖြစ်ပြီး ပြန်လည်အသုံးမပြုပါ။ ဂိမ်းမှ ဖယ်ရှားခံရသော သီချင်းနှင့် chart များသည် serverIds စာရင်း ဗလာဖြင့် catalog တွင် ဆက်ရှိနေမည်။ Entry နှစ်ခုသည် သီချင်းတစ်ပုဒ်တည်း ဖြစ်နေပါက ID တစ်ခုကို ထားပြီး ကျန်တစ်ခုကို ပြန်မသုံးပါ။ ခွဲထုတ်ပါက မူလ ID ကို ထားပြီး အသစ်တစ်ခု ထပ်ထည့်ပါမည်။ နှစ်မျိုးလုံးကို changelog တွင် ကြေညာပါမည်။
အကျုံးဝင်မှု: အကျုံးဝင်သည်: အကောင့်ဝင်ရန် မလိုသော dxdata၊ tag၊ alias နှင့် arcade များ။ Trending နှင့် chart ပုံများကို အတတ်နိုင်ဆုံးသာ ပံ့ပိုးပါသည်။ DXRating အကောင့် လိုအပ်သော endpoint များ (မှတ်ချက်၊ tag ချိတ်ခြင်း၊ alias တင်ခြင်း၊ score တင်သွင်းခြင်း) သည် DXRating ၏ ကိုယ်ပိုင် app များအတွက်သာ ဖြစ်ပြီး အချိန်မရွေး ပြောင်းလဲနိုင်ပါသည်။
အသိပေးချက် ရယူရန်: Field၊ endpoint အသစ်နှင့် deprecation တိုင်းအတွက် email ရရှိရန် GitHub ရှိ changelog issue ကို subscribe လုပ်ပါ။ Changelog
အကူအညီ: မေးခွန်း၊ bug နှင့် တောင်းဆိုချက်များကို GitHub issues တွင် တင်ပါ။ github.com/gekichumai/dxrating