オープンプラットフォーム API ガイド
Moenotes API で公開プロフィール、ランキング、ガチャ情報、許可された gzip セーブを取得します。
概要
アプリ登録ですぐに clientID と Secret が発行されます。ボット、確認コード、審査は不要です。
本プラットフォームはゲーム運営会社の公式 API ではありません。アプリの作成や API キーの管理(発行・失効)はメインサイトのコンソールで行ってください(本静的ドキュメントサイトは閲覧専用です)。アプリの作成に手動審査は不要です。各アプリで保持できる有効なキーは最大2つまでです。キーのローテーションを行う際は、先にクライアント側を新しいキーへ切り替えて動作確認した上で、古いキーを明示的に失効させてください。
公開イベント・楽曲ランキング
イベント・楽曲・チャレンジランキングのデータ取得には、メインサイトでも利用されている公開サービス https://api.bdon.moe/api/v1 の利用を推奨します。本サービスは Passport 認証システムから独立しており、すべての公開エンドポイントは認証情報なし(clientSecret 不要)の GET リクエストを受け付けます。Passport の毎分 100 回 / 毎日 10000 回の制限も消費しません。なお、公開サービスでは固定の更新間隔やサードパーティ製ブラウザ向けの CORS 対応は保証されておらず、無制限のリクエストを許容するものでもありません。適切な頻度で呼び出し、ローカルキャッシュを活用してください。
導入手順
導入手順 · 認証・スコープ・リージョン · 元のセーブをダウンロード · 制限とセキュリティ · エラー処理
API リファレンス
- プロフィールとお気に入り —
moenotes:profiles: 1人の公開プロフィール、複数プロフィールの一括取得、プレイヤーのお気に入り一覧を取得します。 - プロフィールカード画像 —
moenotes:profile-images: プレイヤーのプロフィールカードの1ページを PNG として描画します。 - ランキング —
moenotes:rankings: 楽曲・イベント・チャレンジ・アリーナのランキング。 - 人気編成 —
moenotes:decks: イベントランキングの編成構成とアリーナの編成傾向。 - サークル —
moenotes:circles: id でサークルを取得、または名前と条件で検索します。 - ガチャ確率 —
moenotes:gacha: ガチャ池とピックアップカードの公開確率。 - お知らせ —
moenotes:announcements: ゲーム内お知らせの一覧と詳細。