chunirec API v2.0 ドキュメント

プレイヤーの RATING に関わる情報を取得することができます。

• GET records/rating_data.json

GET records/rating_data.json

通常譜面の全曲レコードを取得します。

エンドポイント

https://api.chunirec.net/2.0/records/rating_data.json

仕様

• 応答形式: JSON
• アクセストークン: 必須

パラメーター

リクエスト例

GET https://api.chunirec.net/2.0/records/rating_data.json?region=jp2&token=YOUR_TOKEN HTTP/1.1

応答例

Status: 200 OK

{
  "best": {
    "value": 16.42,
    "entries": [
      {
        "id": "301708a3c85aadd7",
        "diff": "MAS",
        "level": 14.5,
        "title": "IMPACT",
        "const": 14.7,
        "score": 1008295,
        "rating": 16.77,
        "is_const_unknown": false,
        "is_clear": true,
        "is_fullcombo": false,
        "is_alljustice": false,
        "is_fullchain": false,
        "genre": "ORIGINAL",
        "updated_at": "2022-02-12T00:42:48+0900",
        "is_played": true
      },
      ...
    ]
  },
  "recent": {
    "value": 14.73,
    "entries": [
      {
        "id": "301708a3c85aadd7",
        "diff": "MAS",
        "level": 14.5,
        "title": "IMPACT",
        "const": 14.7,
        "score": 1008295,
        "rating": 16.77,
        "is_const_unknown": false
      },
      ...
    ]
  },
  "best_candidate": {
    "entries": [
      {
        "id": "48fb09ddc956a9a0",
        "diff": "MAS",
        "level": 14,
        "title": "The wheel to the Night ～インド人が夢に!?～",
        "const": 14.1,
        "score": 1008713,
        "rating": 16.22,
        "is_const_unknown": false,
        "is_clear": true,
        "is_fullcombo": true,
        "is_alljustice": false,
        "is_fullchain": false,
        "genre": "イロドリミドリ",
        "updated_at": "1970-01-01T09:00:00+0900",
        "is_played": true
      },
      ...
    ]
  },
  "best_candidate_sss": {
    "entries": [
      {
        "id": "9d901ac670fa9a85",
        "diff": "MAS",
        "level": 14.5,
        "title": "8-EM",
        "const": 14.8,
        "score": 1004070,
        "rating": 16.2,
        "is_const_unknown": false,
        "is_clear": true,
        "is_fullcombo": false,
        "is_alljustice": false,
        "is_fullchain": false,
        "genre": "ORIGINAL",
        "updated_at": "2021-11-10T23:00:21+0900",
        "is_played": true
      },
      ...
  },
  "best_outside": {
    "entries": [
      {
        "id": "48fb09ddc956a9a0",
        "diff": "MAS",
        "level": 14,
        "title": "The wheel to the Night ～インド人が夢に!?～",
        "const": 14.1,
        "score": 1008713,
        "rating": 16.22,
        "is_const_unknown": false,
        "is_clear": true,
        "is_fullcombo": true,
        "is_alljustice": false,
        "is_fullchain": false,
        "genre": "イロドリミドリ",
        "updated_at": "1970-01-01T09:00:00+0900",
        "is_played": true
      },
      ...
    ]
  }
}

備考

• user_id または user_name パラメーターを指定することで他人の情報を取得することが出来ます。省略するとアクセストークン所持者の情報が取得されます。
• 存在しないユーザーにアクセスしようとした場合は 404 Not Found が返ります。
• フレンド同士でない非公開ユーザーにアクセスしようとした場合は 403 Forbidden が返ります。
• best は BEST 枠、recent は RECENT 枠、best_candidate は BEST 枠候補 (最大 20 曲) 、best_candidate_sss はランク SSS 以上のスコアを除いた BEST 枠候補 (最大 20 曲) 、best_outside は BEST 枠外 (最大 20 曲) が含まれています。
• best.entries は BEST 枠対象楽曲が 30 曲に満たない場合は null で埋められ、配列の長さは必ず 30 になります。
• recent.entries は RECENT 枠対象楽曲が 10 曲に満たない場合は null で埋められ、配列の長さは必ず 10 になります。
• best.value と recent.value の値は、それぞれ BEST 枠、RECENT 枠の単曲レートの平均値です。
• パラメーターの region が jp の場合、best_candidate_sss.entries は長さ 0 の空の配列です。
• updated_at が示す UNIX 時間が 0 の場合、その時刻データは利用できないことを示しています。