今の作りと違うことと、REV.にあわせたものが反映されていないので修正予定

Table of Contents

JSONインタフェース Edit

CxB RankPoint Simulatorのデータベースに登録されているデータをJSONで取得できます

公開インタフェースはすべてJSONPに対応しています。Content-Typeは以下で返却します

JSON形式での返却
application/json; charset=utf-8
JSONP形式での返却
application/javascript; charset=utf-8

楽曲情報単曲取得 Edit

パラメータ Edit

項目説明
楽曲番号(必須)コレクションでの連番に準じる番号
コールバック関数名(任意)指定がある場合、コールバック関数でデータをくくってJSONP形式で返却します

URI Edit

リクエスト先URI
http://cxbrank.maplia.jp/api/music/[楽曲番号]?callback=[コールバック関数名]
サンプルURI
http://cxbrank.maplia.jp/api/music/63

レスポンスフィールド Edit

フィールドの出現順序は不定です(保証しません)

フィールドキー名説明
楽曲番号numbernumericコレクションでの連番に準じる番号
タイトルtitlestring楽曲のタイトル(サブタイトルを除く)
サブタイトルsubtitlestring楽曲のサブタイトル(ない場合はnull)
フルタイトルfull_titlestring楽曲の全体タイトル(タイトル+半角スペース+サブタイトル)
期間限定フラグlimitedbool未配信のイベント先行出現曲の場合にtrue、それ以外はfalse
月間RP曲フラグmonthlyboolリクエスト時点の月間RP曲である場合にtrue、それ以外はfalse
STANDARD譜面情報std(ネスト)
レベルlevelnumeric譜面の設定レベル(float値で返却します)
ノート数notesnumeric譜面の総ノート数(ノート種類は区別しません)
HARD譜面情報hrd(ネスト)
レベルlevelnumeric同上
ノート数notesnumeric
MASTER譜面情報mas(ネスト)
レベルlevelnumeric同上
ノート数notesnumeric
EASY譜面情報esy(ネスト)
レベルlevelnumericnull固定
ノート数notesnumericnull固定
UNLIMITED譜面情報unl(ネスト)
レベルlevelnumericnull固定
ノート数notesnumericnull固定

楽曲情報一括取得 Edit

パラメータ Edit

項目説明
コールバック関数名(任意)指定がある場合、コールバック関数でデータをくくってJSONP形式で返却します

URI Edit

リクエスト先URL
http://cxbrank.maplia.jp/api/musics?callback=[コールバック関数名]
サンプルURI
http://cxbrank.maplia.jp/api/musics

レスポンスフィールド Edit

単曲取得と同じ構成のオブジェクトを配列にして、データベースにあるすべての楽曲データを返却します。配列の並びは楽曲番号の昇順です

データ登録インタフェース Edit

プレイ成績データをJSON形式でPOST送信することで、Webでのログインを経ずに直接データの編集ができます

Content-Typeはapplication/jsonで送信(application/x-www-form-urlencodedにはしない)

1曲単位の更新のみ受け付けます(複数更新する場合はその件数だけリクエストする)

リクエストフィールド Edit

ここに含まれるキー以外はすべて無視します

フィールドキー名説明
ユーザIDuser_idstringユーザのID(数字5ケタ)
パスワードpasswordstringユーザのパスワード
楽曲番号numbernumericコレクションでの連番に準じる番号
プレイ成績データskill(ネスト)
コメントcommentstringプレイ成績データに関するコメント







STANDARD譜面std(ネスト)(※省略可能にする予定: 未プレイ状態にする)
プレイ状態statnumeric0:未プレイ、1:クリア済み、2:クリア失敗
RPpointnumeric譜面のRP(小数点以下2ケタのfloat値)
クリアレートratenumeric譜面のクリアレート(0~100のint値)
クリアレートranknumeric0:指定なし、1:S++、2:S+、~、9:D、10:E
フルコンボfcsnumeric0:指定なし、1:フルコンボ、2:All Flawless(エクセ)
ロック状態lockednumeric0:ロックなし、1:ロック状態(または未所持)







HARD譜面hrd(ネスト)
プレイ状態statnumeric同上
RPpointnumeric
クリアレートratenumeric
クリアレートranknumeric
フルコンボfcsnumeric
ロック状態lockednumeric







MASTER譜面mas(ネスト)
プレイ状態statnumeric同上
RPpointnumeric
クリアレートratenumeric
クリアレートranknumeric
フルコンボfcsnumeric
ロック状態lockednumeric

URI Edit

リクエスト先URI
http://cxbrank.maplia.jp/edit_direct

レスポンス Edit

HTTPステータスコードで処理結果を返却します

成否ステータス説明
成功200OK更新(または新規作成)成功
失敗400Bad Request送信データ不備(該当曲が存在しない、バリデーションを通らないなど)
401Unauthorizedユーザ認証失敗(パスワード間違いなど)
405Method Not AllowedリクエストがPOSTメソッドでない
500Internal Server Errorその他の内部エラー(プログラム側のバグかも)

参考 Edit


トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2015-07-27 (月) 00:24:06