ブルーアーカイブAPI

このAPIはブルーアーカイブのグローバル版および日本版のデータを提供します。

• ブルーアーカイブEN: 公式ENサイト
• ブルーアーカイブJP: 公式JPサイト

ゲーム「ブルーアーカイブ」から様々なデータを提供するAPIです。このプロジェクトに貢献したい場合は、プルリクエストやイシューを自由に開いてください。サポートしたい方は、私のKo-Fiに寄付も可能です。

ホストされているAPI：https://api.ennead.cc/buruaka

必要条件

• Go: バージョン1.24以上
• APIからアクセス可能なMongoDBインスタンス（デフォルトのURIはmongodb://localhost:27017）

設定

実行時オプションはYAMLファイルから読み込みます。デフォルトではプロジェクトルートのconfig.yamlを読み込みます。必要に応じてCONFIG_PATH環境変数を設定し、別の設定ファイルを指定してください。

ローカルのデフォルト設定に合った例はconfig.yamlを参照してください。

APIの起動

依存関係をビルドし、Goでサーバーを起動します：

go run ./cmd/server

リスナーのアドレスは設定によって制御されます（デフォルトは 0.0.0.0:9999）。すべてのRESTエンドポイントは /buruaka ベースパスの下で提供されます（例：/buruaka/character）、サーバーは設定されたURIを使ってMongoDBに接続し、キャラクター、レイド、バナーデータを提供します。

スタンドアロンバイナリを生成するには：

go build -o server ./cmd/server

テストを実行するには：

go test ./...

REST API ドキュメント

エンドポイントの詳細はdocsフォルダにあります。

--- Tranlated By Open Ai Tx | Last indexed: 2025-12-31 ---