今の作りと違うことと、REV.にあわせたものが反映されていないので修正予定
Table of Contents |
CxB RankPoint Simulatorのデータベースに登録されているデータをJSONで取得できます
公開インタフェースはすべてJSONPに対応しています。Content-Typeは以下で返却します
項目 | 説明 |
---|---|
楽曲番号(必須) | コレクションでの連番に準じる番号 |
コールバック関数名(任意) | 指定がある場合、コールバック関数でデータをくくってJSONP形式で返却します |
フィールドの出現順序は不定です(保証しません)
フィールド | キー名 | 型 | 説明 | |
楽曲番号 | number | numeric | コレクションでの連番に準じる番号 | |
---|---|---|---|---|
タイトル | title | string | 楽曲のタイトル(サブタイトルを除く) | |
サブタイトル | subtitle | string | 楽曲のサブタイトル(ない場合はnull) | |
フルタイトル | full_title | string | 楽曲の全体タイトル(タイトル+半角スペース+サブタイトル) | |
期間限定フラグ | limited | bool | 未配信のイベント先行出現曲の場合にtrue、それ以外はfalse | |
月間RP曲フラグ | monthly | bool | リクエスト時点の月間RP曲である場合にtrue、それ以外はfalse | |
STANDARD譜面情報 | std | (ネスト) | ||
├ | レベル | level | numeric | 譜面の設定レベル(float値で返却します) |
└ | ノート数 | notes | numeric | 譜面の総ノート数(ノート種類は区別しません) |
HARD譜面情報 | hrd | (ネスト) | ||
├ | レベル | level | numeric | 同上 |
└ | ノート数 | notes | numeric | |
MASTER譜面情報 | mas | (ネスト) | ||
├ | レベル | level | numeric | 同上 |
└ | ノート数 | notes | numeric | |
EASY譜面情報 | esy | (ネスト) | ||
├ | レベル | level | numeric | null固定 |
└ | ノート数 | notes | numeric | null固定 |
UNLIMITED譜面情報 | unl | (ネスト) | ||
├ | レベル | level | numeric | null固定 |
└ | ノート数 | notes | numeric | null固定 |
項目 | 説明 |
---|---|
コールバック関数名(任意) | 指定がある場合、コールバック関数でデータをくくってJSONP形式で返却します |
単曲取得と同じ構成のオブジェクトを配列にして、データベースにあるすべての楽曲データを返却します。配列の並びは楽曲番号の昇順です
プレイ成績データをJSON形式でPOST送信することで、Webでのログインを経ずに直接データの編集ができます
Content-Typeはapplication/jsonで送信(application/x-www-form-urlencodedにはしない)
1曲単位の更新のみ受け付けます(複数更新する場合はその件数だけリクエストする)
ここに含まれるキー以外はすべて無視します
フィールド | キー名 | 型 | 説明 | ||
ユーザID | user_id | string | ユーザのID(数字5ケタ) | ||
---|---|---|---|---|---|
パスワード | password | string | ユーザのパスワード | ||
楽曲番号 | number | numeric | コレクションでの連番に準じる番号 | ||
プレイ成績データ | skill | (ネスト) | |||
├ | コメント | comment | string | プレイ成績データに関するコメント | |
├ │ │ │ │ │ │ │ | STANDARD譜面 | std | (ネスト) | (※省略可能にする予定: 未プレイ状態にする) | |
├ | プレイ状態 | stat | numeric | 0:未プレイ、1:クリア済み、2:クリア失敗 | |
├ | RP | point | numeric | 譜面のRP(小数点以下2ケタのfloat値) | |
├ | クリアレート | rate | numeric | 譜面のクリアレート(0~100のint値) | |
├ | クリアレート | rank | numeric | 0:指定なし、1:S++、2:S+、~、9:D、10:E | |
├ | フルコンボ | fcs | numeric | 0:指定なし、1:フルコンボ、2:All Flawless(エクセ) | |
└ | ロック状態 | locked | numeric | 0:ロックなし、1:ロック状態(または未所持) | |
├ │ │ │ │ │ │ │ | HARD譜面 | hrd | (ネスト) | ||
├ | プレイ状態 | stat | numeric | 同上 | |
├ | RP | point | numeric | ||
├ | クリアレート | rate | numeric | ||
├ | クリアレート | rank | numeric | ||
├ | フルコンボ | fcs | numeric | ||
└ | ロック状態 | locked | numeric | ||
├ │ │ │ │ │ │ │ | MASTER譜面 | mas | (ネスト) | ||
├ | プレイ状態 | stat | numeric | 同上 | |
├ | RP | point | numeric | ||
├ | クリアレート | rate | numeric | ||
├ | クリアレート | rank | numeric | ||
├ | フルコンボ | fcs | numeric | ||
└ | ロック状態 | locked | numeric |
HTTPステータスコードで処理結果を返却します
成否 | ステータス | 説明 | |
---|---|---|---|
成功 | 200 | OK | 更新(または新規作成)成功 |
失敗 | 400 | Bad Request | 送信データ不備(該当曲が存在しない、バリデーションを通らないなど) |
401 | Unauthorized | ユーザ認証失敗(パスワード間違いなど) | |
405 | Method Not Allowed | リクエストがPOSTメソッドでない | |
500 | Internal Server Error | その他の内部エラー(プログラム側のバグかも) |