Skip to content
This repository has been archived by the owner on Jul 5, 2021. It is now read-only.

Reference of v3 random

TheSnowfield edited this page Jan 21, 2021 · 4 revisions
arguments description optional
start range of start YES when end is not passed in
end range of end YES
info returns song info
when set true
YES

The default range is 2 to 23.

For easier storage and higher compatibility
We expanded the song rating table from

1 2 3 4 5 6 7 8 9 9+ 10 10+ 11

to

1 1+ 2 2+ 3 3+ 4 4+ 5 5+ 6 6+ 7 7+ 8 8+ 9 9+ 10 10+ 11 11+

So the algorithm is (ratingNumber * 2) + (ratingPlus ? 1 : 0)
As you can see, now the range is 2 to 23.

content.song_info is same with v3/songinfo

Return data

{
    "status": 0,
    "content": {
        "id": "ifi",
        "rating_class": 2,
        "song_info": {
            "id": "ifi",
            "title_localized": {
                "en": "#1f1e33"
            },
            "artist": "かめりあ(EDP)",
            "bpm": "181",
            "bpm_base": 181,
            "set": "vs",
            "audioTimeSec": 163,
            "side": 1,
            "remote_dl": true,
            "world_unlock": false,
            "date": 1590537604,
            "difficulties": [
                {
                    "ratingClass": 0,
                    "chartDesigner": "夜浪",
                    "jacketDesigner": "望月けい",
                    "rating": 5,
                    "ratingReal": 5.5,
		    "totalNotes": 765
                },
                {
                    "ratingClass": 1,
                    "chartDesigner": "夜浪",
                    "jacketDesigner": "望月けい",
                    "rating": 9,
                    "ratingReal": 9.2,
		    "totalNotes": 1144
                },
                {
                    "ratingClass": 2,
                    "chartDesigner": "夜浪 VS 東星 \"Convergence\"",
                    "jacketDesigner": "望月けい",
                    "rating": 10,
                    "ratingReal": 10.9,
                    "ratingPlus": true,
		    "totalNotes": 1576
                }
            ]
        }
    }
}

Error status

status description
0 everything is OK
-1 invalid range of start
-2 invalid range of end
-3 internal error
-4 internal error
-233 unknown error occurred
Clone this wiki locally