Sakura Taiko Viewer / scoretoken

Web スコア token

連携中の太鼓 ID の最新 userdata を、許可したサイトやツールから読み取るための秘密キーです。

多端同期に戻る

ユーザーガイド

1
Viewer にログインし、「アカウント > 多端同期」を開きます。
2
対象の太鼓 ID が現在の連携先になっていることを確認します。
3
「token を発行」を押し、今回だけ表示される 48 文字の token を利用先へ登録します。
4
漏えいした可能性がある場合は、同じ画面で更新または無効化します。

開発者 API

MethodPOST

Endpointhttps://sakura-bot.cn/api/public-score/by-token

Content-Typeapplication/json

リクエスト

curl -X POST "https://sakura-bot.cn/api/public-score/by-token" \
  -H "Content-Type: application/json" \
  -d '{"token":"用户的48位token"}'

成功レスポンス

{
  "ok": true,
  "taikoId": "2258735",
  "fetchedAt": "2026-08-05T12:30:20Z",
  "data": {
    "profile": {
      "mydon_name": "SakuraDon",
      "userid": "2258735",
      "is_disp_dan_on": true,
      "province": "北京市",
      "gameCostume": {
        "title": "太鼓达人",
        "got_dan_max": 6,
        "dan_name": { "grade": "06", "level": 1 }
      }
    },
    "songs": [
      {
        "song_no": 187,
        "level": 4,
        "high_score": 1000000,
        "best_score_rank": 7,
        "good_cnt": 160,
        "ok_cnt": 0,
        "ng_cnt": 0,
        "combo_cnt": 160,
        "clear_cnt": 1,
        "full_combo_cnt": 1,
        "dondaful_combo_cnt": 1,
        "highscore_datetime": "2026-08-05 20:30:20"
      }
    ],
    "achievement": {
      "count_level": 5,
      "ary_crown_count": [250, 3, 0],
      "ary_score_rank_count": [19, 56, 136, 142, 29, 1, 0]
    }
  }
}

例では 1 曲だけを掲載しています。実際の songs にはユーザーの全スコアが含まれます。

主なエラー

400请求体或 token 字段不合法

401token 无效、已轮换或已撤销

404绑定 ID 或本地成绩不存在

502上游成绩拉取失败

実装上の注意

ブラウザから直接呼び出せる CORS 対応 API ですが、バックエンド経由の利用を推奨します。
レスポンス前に最新スコアの取得を試みるため、連続リクエストは避け、短時間キャッシュを設けてください。
token をログ、分析イベント、URL クエリに記録しないでください。