コンテンツにスキップ
ChuniSupport ガイド

WORLD'S END

WORLD’S END楽曲の一覧・詳細・スコア履歴を取得するAPIです。

GET /v1/worldsend-songs

Section titled “GET /v1/worldsend-songs”

全WORLD’S END楽曲を取得します。削除済み楽曲は除外されます。WORLD’S ENDは1曲1譜面です。

リクエスト:

GET /v1/worldsend-songs
Authorization: Bearer <APIトークン>

レスポンス: 200 OK

{
  "songs": [
    {
      "id": "f13e1a1f3285186c",
      "title": "Garakuta Doll Play (sasakure.UK clutter remix)",
      "reading": "GARAKUTADOLLPLAYSASAKUREUKCLUTTERREMIX",
      "artist": "sasakure.UK",
      "genre": "ORIGINAL",
      "bpm": 256,
      "release": "2016-03-17",
      "jacket": "971c362a9b65209e",
      "official_idx": "8024",
      "charts": {
        "WORLDSEND": {
          "attribute": "改",
          "level_star": 4,
          "notes": 2525,
          "notes_designer": "チュウニ譜面ボーイズ"
        }
      }
    }
  ]
}
フィールド型説明
songsarrayWORLD’S END楽曲の配列
songs[].idstring楽曲のID
songs[].titlestring楽曲名
songs[].readingstring | null楽曲名の読み
songs[].artiststringアーティスト名
songs[].genrestring | nullジャンル名
songs[].bpmnumber | nullBPM
songs[].releasestring | nullリリース日（YYYY-MM-DD 形式）
songs[].jacketstring | nullジャケット画像ファイル名
songs[].official_idxstring公式ID
songs[].chartsobject譜面情報。キーは "WORLDSEND" 固定
songs[].charts.WORLDSEND.attributestring | nullWORLD’S END属性（光、蔵、改、狂 など）
songs[].charts.WORLDSEND.level_starnumber | nullWORLD’S ENDレベル（1～5）
songs[].charts.WORLDSEND.notesnumber | nullノーツ数
songs[].charts.WORLDSEND.notes_designerstring | nullノーツデザイナー

GET /v1/worldsend-songs/:id

Section titled “GET /v1/worldsend-songs/:id”

指定されたWORLD’S END楽曲の詳細を取得します。

リクエスト:

GET /v1/worldsend-songs/f13e1a1f3285186c
Authorization: Bearer <APIトークン>

パスパラメータ:

パラメータ型説明
idstring楽曲のID

レスポンス: 200 OK

{
  "id": "f13e1a1f3285186c",
  "title": "Garakuta Doll Play (sasakure.UK clutter remix)",
  "reading": "GARAKUTADOLLPLAYSASAKUREUKCLUTTERREMIX",
  "artist": "sasakure.UK",
  "genre": "ORIGINAL",
  "bpm": 256,
  "release": "2016-03-17",
  "jacket": "971c362a9b65209e",
  "official_idx": "8024",
  "charts": {
    "WORLDSEND": {
      "attribute": "改",
      "level_star": 4,
      "notes": 2525,
      "notes_designer": "チュウニ譜面ボーイズ"
    }
  }
}

フィールドの詳細は GET /v1/worldsend-songs を参照してください。

エラー:

コードHTTP説明
song_not_found404指定された楽曲が見つかりません

GET /v1/worldsend-songs/:id/score-history

Section titled “GET /v1/worldsend-songs/:id/score-history”

指定WORLD’S END楽曲のスコア履歴を取得します。履歴は譜面ごとに最大50件で、レスポンス先頭の現行ベストを含めると最大51件です。

認証: APIトークン必須。非公開ユーザーは本人または承認済みフレンドのみ参照できます。

リクエスト:

GET /v1/worldsend-songs/c953760500a52748/score-history?username=kjumanenobikto
Authorization: Bearer <APIトークン>

パスパラメータ:

パラメータ型説明
idstringWORLD’S END楽曲のID

クエリパラメータ:

パラメータ型必須説明
usernamestring✓対象ユーザー名

レスポンス: 200 OK

レスポンス形式は GET /v1/songs/:id/score-history/:difficulty と同一です。

エラー:

コードHTTP説明
validation_failed400username が未指定です
score_history_not_found404スコア履歴が存在しません（未プレイ）
user_not_found404ユーザーが見つからない、または非公開設定のため閲覧できません