API仕様書
- はじめに
- ユーザー情報取得
- スコア情報取得 (plus)
- スコア情報取得 (knit / copious)
- スコア登録履歴情報取得
- 楽曲情報取得
- 楽曲情報一覧取得
- jubeat++で公開されている情報とほぼ同じものを、プログラムから使いやすい形式で取得することができます
- 対応形式はJSONとJSONPのみです。それ以外の形式は今のところ対応予定はありません
- 当APIの利用に関して事前にも事後にもこちらへの報告は特に必要ありません（報告されれば嬉しいですがｗ）
-
当APIへのアクセス頻度に関しても特に規制はありません。インフラはそれなりにしっかりしてると思うのでAPIの呼び出しくらいで落ちることはないと思います。
大丈夫、googleのサーバーだよ！
-
利用に関しては自己責任でお願いします。ここに書いてあることが全てなので技術的なサポートはまずないと思ってください。
（例：特定のプログラミング言語から当APIを呼んで変数に格納する方法とか）
JSONについて詳しいことはこちらを御覧ください
http://www.json.org/json-ja.html
リクエストURL
http://jubeatplusplus.appspot.com/api/user/[ユーザーID]?callback=[コールバック関数]
パラメータ
| 項目名 |
説明 |
例 |
|
ユーザーID (必須)
|
jubeat++内のユーザーID（ http://jubeatplusplus.appspot.com/user/○○ のやつです）
|
sue445
|
|
コールバック関数 (任意)
|
指定されていた場合コールバック関数を付加してJSONP形式で返却します
|
callback({JSONオブジェクト})
|
サンプルURL
http://jubeatplusplus.appspot.com/api/user/sue445
レスポンスフィールド
| フィールド |
説明 |
例 |
|
userId
|
ユーザID
|
sue445
|
|
userName
|
ユーザ名
|
sue445
|
|
description
|
自己紹介文
|
|
|
device
|
使用機種
|
IPAD / IPHONE / SYSTEM
(SYSTEMはaverage_san, average_ipad, average_iphoneのみ)
|
|
screenName
|
TwitterのscreenName（対象ユーザーがTwitterと連携している時のみ取得可能）
|
sue445
|
|
friendId
|
jubeat knitのフレンドID（対象ユーザーがjubegraphと連携している時のみ取得可能）
|
24400025685932
|
|
cardName
|
juneat knitのカード名（対象ユーザーがjubegraphと連携している時のみ取得可能）
|
SUE445
|
サンプルレスポンス
{
"cardName": "SUE445",
"description": "jubeat++の中の人です\r\nhttp://www.sue445.net/\r\n",
"device": "IPAD",
"friendId": "24400025685932",
"screenName": "sue445",
"userId": "sue445",
"userName": "sue445"
}
|
リクエストURL
http://jubeatplusplus.appspot.com/api/score/[ユーザーID]?callback=[コールバック関数]
パラメータ
| 項目名 |
説明 |
例 |
|
ユーザーID (必須)
|
jubeat++内のユーザーID（ http://jubeatplusplus.appspot.com/user/○○ のやつです）
|
sue445
|
|
コールバック関数 (任意)
|
指定されていた場合コールバック関数を付加してJSONP形式で返却します
|
callback({JSONオブジェクト})
|
サンプルURL
http://jubeatplusplus.appspot.com/api/score/sue445
レスポンスフィールド
下記が配列の要素として全楽曲分並んでいます（今のところ配信順で並んでいますが、今後並びが変わるかもしれないので並び順に依存した実装はしない方がいいです）
| フィールド |
説明 |
例 |
|
tuneId
|
楽曲ID。MusicScores.sqliteのZTUNEIDと同一の物です
|
100000201
|
|
title
|
楽曲名。jubeat knitにもある曲に関してはjubegraphの生データ中の楽曲名と同一の物です
|
ウィリアム・テル序曲
|
|
playCount
|
プレイ回数。BASIC, ADVANCED, EXTREMEの合計
|
10
|
|
basic
|
BASICのスコア情報（ネストされています）
|
914035
|
|
├score
|
スコア
|
|
|
├fullCombo
|
フルコンボフラグ。trueならフルコンボ達成済, falseならフルコンボ未達成
|
true / false
|
|
├updatedAt
|
最終更新日時。JSTのYYYY/MM/DD HH:MM:SS
|
2011/03/29 01:12:25
|
|
advanced
|
ADVANCEDのスコア情報（ネストされています）
|
|
|
├score
|
スコア
|
914035
|
|
├fullCombo
|
フルコンボフラグ。trueならフルコンボ達成済, falseならフルコンボ未達成
|
true / false
|
|
├updatedAt
|
最終更新日時。JSTのYYYY/MM/DD HH:MM:SS
|
2011/03/29 01:12:25
|
|
extreme
|
EXTREMEのスコア情報（ネストされています）
|
|
|
├score
|
スコア
|
914035
|
|
├fullCombo
|
フルコンボフラグ。trueならフルコンボ達成済, falseならフルコンボ未達成
|
true / false
|
|
├updatedAt
|
最終更新日時。JSTのYYYY/MM/DD HH:MM:SS
|
2011/03/29 01:12:25
|
サンプルレスポンス
[
{
"advanced": {
"fullCombo": false,
"score": 736831,
"updatedAt": "2011/03/29 01:12:25"
},
"basic": {
"fullCombo": true,
"score": 914035,
"updatedAt": "2011/03/29 01:12:25"
},
"extreme": {
"fullCombo": false,
"score": 573392,
"updatedAt": "2011/03/29 01:12:25"
},
"playCount": 8,
"title": "ウィリアム・テル序曲",
"tuneId": "100000201"
},
{
"advanced": {
"fullCombo": false,
"score": 850020,
"updatedAt": "2011/03/29 01:12:25"
},
"basic": {
"fullCombo": false,
"score": 820322,
"updatedAt": "2011/03/29 01:12:25"
},
"extreme": {
"fullCombo": false,
"score": 0,
"updatedAt": null
},
"playCount": 8,
"title": "Sweet Rain",
"tuneId": "100000315"
},
（中略）
]
|
リクエストURL
http://jubeatplusplus.appspot.com/api/scoreKnit/[ユーザーID]?callback=[コールバック関数]
http://jubeatplusplus.appspot.com/api/scoreCopious/[ユーザーID]?callback=[コールバック関数]
パラメータ
スコア情報取得 (plus)と同じです。
サンプルURL
http://jubeatplusplus.appspot.com/api/scoreKnit/sue445
http://jubeatplusplus.appspot.com/api/scoreCopious/sue445
レスポンスフィールド
スコア情報取得 (plus)と同じです。（フルコンボフラグプレイ回数は未使用）
備考
- plusとknit(copious)の両方にある楽曲しか返しません
- そのユーザーがjubegraph knit(copious)と連携していなかった場合は404エラーが返ります
リクエストURL
http://jubeatplusplus.appspot.com/api/history/[ユーザーID]/[楽曲ID]?callback=[コールバック関数]
パラメータ
| 項目名 |
説明 |
例 |
|
ユーザーID (必須)
|
jubeat++内のユーザーID（ http://jubeatplusplus.appspot.com/user/○○ のやつです）
|
sue445
|
|
楽曲ID (必須)
|
スコア情報のtuneIdで取れる物
|
100000201 (=ウィリアム・テル序曲)
|
|
コールバック関数 (任意)
|
指定されていた場合コールバック関数を付加してJSONP形式で返却します
|
callback({JSONオブジェクト})
|
サンプルURL
http://jubeatplusplus.appspot.com/api/history/sue445/100000201
レスポンスフィールド
下記が配列の要素として最大100件分並んでいます（100件を超えた場合古い履歴は消えていきます）
| フィールド |
説明 |
例 |
|
seqNo
|
連番。配列の要素の最初から1から順に入っています
|
1～
|
|
registedAt
|
登録日時。JSTのYYYY/MM/DD HH:MM:SS
|
2011/03/29 01:12:25
|
|
basicScore
|
登録時点でのBASICスコア
|
914035
|
|
advancedScore
|
登録時点でのADVANCEDスコア
|
736831
|
|
extremeScore
|
登録時点でのEXTREMEスコア
|
573392
|
|
playCount
|
登録時点でのプレイ回数
|
8
|
サンプルレスポンス
[
{
"advancedScore": 736831,
"basicScore": 914035,
"extremeScore": 573392,
"playCount": 8,
"registedAt": "2011/03/29 01:12:25",
"seqNo": 1
},
{
"advancedScore": 736831,
"basicScore": 914035,
"extremeScore": 573392,
"playCount": 8,
"registedAt": "2011/03/29 23:38:58",
"seqNo": 2
},
（中略）
]
|
リクエストURL
http://jubeatplusplus.appspot.com/api/music/[楽曲ID]?callback=[コールバック関数]
パラメータ
| 項目名 |
説明 |
例 |
|
楽曲ID (必須)
|
スコア情報のtuneIdで取れる物
|
100000201 (=ウィリアム・テル序曲)
|
|
コールバック関数 (任意)
|
指定されていた場合コールバック関数を付加してJSONP形式で返却します
|
callback({JSONオブジェクト})
|
サンプルURL
http://jubeatplusplus.appspot.com/api/music/100000201
レスポンスフィールド
| フィールド |
説明 |
例 |
|
tuneId
|
楽曲ID。MusicScores.sqliteのZTUNEIDと同一の物です
|
100000201
|
|
title
|
楽曲名。jubeat knitにもある曲に関してはjubegraphの生データ中の楽曲名と同一の物です
|
ウィリアム・テル序曲
|
|
readingTitle
|
楽曲名（よみがな）
|
うぃりあむてるじょきょく
|
|
basicLevel
|
BASICのレベル
|
3
|
|
advancedLevel
|
ADVANCEDのレベル
|
7
|
|
extremeLevel
|
EXTREMEのレベル
|
9
|
サンプルレスポンス
{"advancedLevel":7,"basicLevel":3,"extremeLevel":9,"readingTitle":"うぃりあむてるじょきょく","title":"ウィリアム・テル序曲","tuneId":"100000201"}
|
リクエストURL
http://jubeatplusplus.appspot.com/api/musicList?callback=[コールバック関数]
パラメータ
| 項目名 |
説明 |
例 |
|
コールバック関数 (任意)
|
指定されていた場合コールバック関数を付加してJSONP形式で返却します
|
callback({JSONオブジェクト})
|
サンプルURL
http://jubeatplusplus.appspot.com/api/musicList
レスポンスフィールド
楽曲情報取得と同じ形式のオブジェクトが配列で返ります（五十音順）
サンプルレスポンス
[
{
"advancedLevel":7,
"basicLevel":4,
"extremeLevel":9,
"readingTitle":"あーるぴーじー",
"title":"R.P.G.～Rockin' Playing Game",
"tuneId":"321040003"
},
{
"advancedLevel":6,
"basicLevel":2,
"extremeLevel":8,
"readingTitle":"あいえむてぃーえー",
"title":"IMTA （DIL mix)",
"tuneId":"311070002"
},
（略）
]
|
トップに戻る
