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

プレイヤーランキング

警告

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

特定のプレイヤーの各種ランキング(整地量・建築量・投票数・接続時間の総合・日間・週間・月間・年間ランキング)を取得できます。
使用例はこちら -> https://seichi.conarin.com/ranking/players

エンドポイント​

GET /seichi/ranking/players/{playerName}
GET /seichi/ranking/players/{UUID}

クエリパラメータ​

名前型内容初期値
durationstringランキングの期間
total、daily、weekly、monthly、yearlyをカンマ区切りで指定		total
typesstringランキングの種類
break_count、build_count、play_ticks、vote_countをカンマ区切りで指定		break_count
datestringデータの年月日
YYYY-MM-DD形式で指定		JSTでの現在の日付

例​

GET /seichi/ranking/players/unchama?duration=total&types=build_count,break_count&date=2023-07-05
GET /seichi/ranking/players/b66cc3f6-a045-42ad-b4b8-320f20caf140?duration=total&types=build_count,break_count&date=2023-07-05

レスポンス​

成功時​

名前型内容
playerobjectプレイヤーデータの構造を参照
levelsobjectプレイヤーデータの構造を参照
ranksarrayプレイヤーデータの構造を参照
lastLoginAtstringプレイヤーデータの構造を参照
updatedAtstringランキングデータの更新日時
形式はYYYY-MM-DDThh:mm:ss+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
        },
        {
            "duration": "total",
            "type": "build_count",
            "value": "9944",
            "rank": 2895
        }
    ],
    "lastLoginAt": "1970-01-01T09:00:00+09:00",
    "updatedAt": "2023-07-05T23:59:33+09:00"
}

例外時​

名前型内容
errorobjectエラー情報が格納されたオブジェクト
error.codenumberHTTPステータスコード
400か404か503のいずれか
error.messagestringエラーメッセージ。以下のいずれか

400
・UUIDかユーザー名の形式が正しくありません。
404
・存在しないプレイヤーです。
・西暦/月/日(曜)のデータはありません。
503
・データの取得に失敗しました。時間を空けて再度お試しください。
・もしこのメッセージが表示されたら開発者に報告お願いします。
{
    "error": {
        "code": 404,
        "message": "2023/07/05(水)のデータはありません。"
    }
}

更新履歴​

  • 2022/12/24 公開
  • 2023/07/05 dateパラメータを追加
  • 2023/09/24 lastLoginAtプロパティを追加