メインコンテンツまでスキップ

プレイヤーデータの構造

警告

本APIは将来的に廃止(破壊的な仕様変更)を予定しています。
移行期間や廃止日が決定次第、サポートサーバーおよびTwitterアカウントにてお知らせいたします。

ランキングAPIおよびプレイヤーランキングAPIで使用されるプレイヤーデータのデータ構造。

名前内容
playerobjectプレイヤー情報が格納されたobject
player.uuidstringプレイヤーのUUID
player.namestringプレイヤー名
※アカウント削除などにより、プレイヤーが存在しない場合は存在しないプレイヤーですが返る
levelsobject各種レベルが格納されたobject
levels.seichiobject整地レベルが格納されたobject
levels.seichi.levelnumber整地レベル
levels.seichi.starLevelnumber整地スターレベル
levels.buildobject建築レベルが格納されたobject
levels.build.levelnumber建築レベル
ranksarrayランキングデータのオブジェクトが格納された配列
ranks[x]objectランキングデータのオブジェクト
ranks[x].durationstringランキングの期間。totaldailyweeklymonthlyyearlyのいずれか
ranks[x].typestringランキングの種類。break_countbuild_countplay_ticksvote_countのいずれか
ranks[x].valuestringランキングの値。それぞれの単位は、整地・建築量はブロック数、接続時間はtick(1/20秒)、投票数は投票回数
ranks[x].ranknumberランキングの順位
lastLoginAtstring最終ログイン日時(厳密にはプレイヤーのログイン時間が増加した日時)。
形式はYYYY-MM-DDThh:mm:ss+09:00。データが無いプレイヤーは1970-01-01T09:00:00+09:00が返る
{
"player": {
"uuid": "b66cc3f6-a045-42ad-b4b8-320f20caf140",
"name": "unchama"
},
"levels": {
"seichi": {
"level": 55,
"starLevel": 0
},
"build": {
"level": 20
}
},
"ranks": [
{
"duration": "total",
"type": "break_count",
"value": "1781920",
"rank": 4387
}
],
"lastLoginAt": "1970-01-01T09:00:00+09:00"
}