Skip to content

API リファレンス ​

WARNING

本ページは旧 Wiki から移行したもので、インターフェースは MajdataNet サーバーの更新に伴って変更される可能性があります。実際にデプロイされているパス、パラメーター、レスポンス構造はサーバー側の実装を基準にしてください。

以下のパスは、サーバーの API ルートアドレスからの相対パスです。クライアントは system-settings.json の Network.Online.ApiEndpoints[].Url でルートアドレスを設定します。デフォルト値は https://majdata.net/api3/api/ です。

Account ​

メソッドパスContent-Typeパラメーター
POST/api/account/Registermultipart/form-datausername、password、email、cf-turnstile-response
POST/api/account/Loginmultipart/form-datausername、password、rememberMe (デフォルトは false)
POST/api/account/logout-クエリパラメーター sessionId
GET/api/account/info-現在サインインしているユーザーの情報
GET/api/account/session-現在のセッション
GET/api/account/sessions-すべてのセッション
GET/api/account/intro-username (デフォルトは空)
POST/api/account/intromultipart/form-datacontent
GET/api/account/icon-username
GET/api/account/Recent-username
GET/api/account/verify-otp
POST/api/account/forgetmultipart/form-datausername、email
PUT/api/account/forgetmultipart/form-dataotp、newpassword

Collection ​

メソッドパスパラメーター
GET/api/collection/listpage (デフォルトは 0)、pageSize (デフォルトは 30)
POST/api/collection/createJSON: name、description、visibility
GET/api/collection/{idStr}/hashlist-
GET/api/collection/{idStr}/songlist-
POST/api/collection/{idStr}/destroy-
POST/api/collection/{idStr}/modifyJSON: name、description、visibility、items

visibility: 0 は非公開、1 は公開です。

json
{
  "name": "string",
  "description": "string",
  "visibility": 0,
  "items": [
    "hash1",
    "hash2"
  ]
}

MaiChart ​

メソッドパスパラメーター
GET/api/maichart/listsort、search、page、isRanking
GET/api/maichart/{chartId}/summary-
GET/api/maichart/{chartId}/chartmaidata.txt を返します
GET/api/maichart/{chartId}/track音声を返します。通常は MP3 です
GET/api/maichart/{chartId}/imagefullImage (デフォルトは false)
GET/api/maichart/{chartId}/video動画がない場合は 404 を返します

chartId は文字列です。譜面ハッシュは maidata.txt の MD5 Base64 値です。

Score ​

メソッドパスパラメーター
GET/api/maichart/{chartId}/score譜面のスコアを取得します
POST/api/maichart/{chartId}/scoreスコアを送信します
json
{
  "chartLevel": 0,
  "hash": "string",
  "dxScore": 0,
  "comboState": 0,
  "acc": {
    "dx": 0,
    "classic": 0
  }
}

Interaction ​

メソッドパスパラメーター
GET/api/maichart/{chartId}/interact-
POST/api/maichart/{chartId}/interacttype、content、replyTo
DELETE/api/maichart/{chartId}/interacttype、commentId

POST では multipart/form-data を使用します。

Machine ​

メソッドパスパラメーター
POST/api/machine/registerJSON: name、description
GET/api/machine/Infomachine-id
json
{
  "name": "string",
  "description": "string"
}

Persist ​

メソッドパス説明
GET/api/persist/app/{appId}/{category}アプリケーションデータを取得します
POST/api/persist/app/1096/settingsアプリケーション設定を更新します

Upload ​

メソッドパスパラメーター
POST/api/maichart/uploadmultipart/form-data、ファイルフィールドは formfiles
POST/api/maichart/deletechartId

Statistics ​

メソッドパスパラメーター
GET/api/stats/score-sumsuploader、page、pageSize

Utility ​

メソッドパス説明
GET/api/utils/PingAPI サービスがオンラインかどうかを確認します

サーバー実装のポイント ​

ゲームは起動後にまず曲の一覧全体を取得します。

http
GET /api/maichart/list

レスポンスの例:

json
[
  {
    "id": "1",
    "title": "花の塔",
    "artist": "さユり",
    "designer": "FTOWER",
    "description": "MMFC10场外",
    "levels": [null, null, null, null, "13+", null, null],
    "timestamp": "2025-03-05T14:45:24.4705018+08:00",
    "hash": "naksqJTTV0fMM//FRcdO0g=="
  }
]
  • id は文字列で、以降の譜面リクエストに使用します。
  • hash は maidata.txt の MD5 Base64 値で、スコアの保存やローカル楽曲ライブラリとの照合に使用します。
  • ゲームはダウンロードした譜面のハッシュを検証し、一致しない場合は終了します。

ハッシュ計算の例:

csharp
var chartHash = MD5.Create().ComputeHash(File.ReadAllBytes(maidatapath + "maidata.txt"));
songDetail.Hash = Convert.ToBase64String(chartHash);

chart、track、image、video は実際のファイル内容を返してください。カバー画像はまずサムネイルを返し、fullImage=true の場合にのみフルサイズの画像を返すのが望ましいです。動画がない場合、video は 404 を返します。