Princess — Public REST API

GET https://api.matsurihi.me/api/mltd/v2/version/latest

レスポンス

レスポンスボディ

• Object app アプリのバージョン情報

  必須アプリバージョンにもとづくため、実際には配信されていないバージョンが返される可能性があります。

  • String version バージョン

  • DateTime updatedAt 強制アップデート日時

  • Integer|null revision リビジョン番号

    配信されていないバージョンの場合には null が返ります。

• Object asset アセットのバージョン情報

  • Integer version バージョン

  • DateTime updatedAt 配信日時

  • String indexName

サンプル

https://api.matsurihi.me/api/mltd/v2/version/latest

curl 'https://api.matsurihi.me/api/mltd/v2/version/latest'

レスポンスボディ

{
  "app": {
    "version": "5.1.050",
    "updatedAt": "2022-11-26T12:00:00+09:00",
    "revision": 749332
  },
  "asset": {
    "version": 773000,
    "updatedAt": "2022-11-26T12:00:00+09:00",
    "indexName": "41f0f6c8d80bc95f405c66875a0b1308b6e67443.data"
  }
}

GET https://api.matsurihi.me/api/mltd/v2/version/apps/:version

リクエスト

パスパラメータ

• String version バージョン

  バージョンを指定しない場合、レスポンスはすべてのバージョンの配列になります。

レスポンス

レスポンスボディ（パスパラメータ省略時のみ配列）

• String version バージョン

• DateTime updatedAt 強制アップデート日時

• Integer|null revision リビジョン番号

  配信されていないバージョンの場合は null が返ります。

サンプル

https://api.matsurihi.me/api/mltd/v2/version/apps

curl 'https://api.matsurihi.me/api/mltd/v2/version/apps'

レスポンスボディ

[
  {
    "version": "1.0.6",
    "updatedAt": "2017-06-28T00:00:00+09:00",
    "revision": 63141
  },
  {
    "version": "1.0.7",
    "updatedAt": "2017-07-15T15:00:00+09:00",
    "revision": 66894
  },
  {
    "version": "1.0.9",
    "updatedAt": "2017-07-27T15:00:00+09:00",
    "revision": 70661
  },
  {
    "version": "1.1.0",
    "updatedAt": "2017-08-09T15:00:00+09:00",
    "revision": 76059
  }
]

https://api.matsurihi.me/api/mltd/v2/version/apps/1.0.6

curl 'https://api.matsurihi.me/api/mltd/v2/version/apps/1.0.6'

レスポンスボディ

{
  "version": "1.0.6",
  "updatedAt": "2017-06-28T00:00:00+09:00",
  "revision": 63141
}

GET https://api.matsurihi.me/api/mltd/v2/version/assets/:version

リクエスト

パスパラメータ

• Integer version バージョン

  バージョンを指定しない場合、レスポンスはすべてのバージョンの配列になります。

レスポンス

レスポンスボディ（パスパラメータ省略時のみ配列）

• Integer version バージョン

• DateTime updatedAt 配信日時

• String indexName

サンプル

https://api.matsurihi.me/api/mltd/v2/version/assets

curl 'https://api.matsurihi.me/api/mltd/v2/version/assets'

レスポンスボディ

[
  {
    "version": 1,
    "updatedAt": "2017-06-29T12:00:00+09:00",
    "indexName": "6b976a4c875a1984592a66b621872ce44c944e72.data"
  },
  {
    "version": 2,
    "updatedAt": "2017-07-11T17:00:00+09:00",
    "indexName": "83a751e34531a81e83ac5e47393bbb7d483c3da5.data"
  },
  {
    "version": 3,
    "updatedAt": "2017-07-13T15:00:00+09:00",
    "indexName": "77104ecc982fd2344e965f6aba2e83c35a4d49f2.data"
  }
]

https://api.matsurihi.me/api/mltd/v2/version/assets/1

curl 'https://api.matsurihi.me/api/mltd/v2/version/assets/1'

レスポンスボディ

{
  "version": 1,
  "updatedAt": "2017-06-29T12:00:00+09:00",
  "indexName": "6b976a4c875a1984592a66b621872ce44c944e72.data"
}

GET https://api.matsurihi.me/api/mltd/v2/idols/:idolId

リクエスト

パスパラメータ

• Integer idolId アイドルの ID

  ID を指定しない場合、レスポンスはすべてのアイドルの配列になります。

レスポンス

レスポンスボディ（パスパラメータ省略時のみ配列）

• Integer id ID

• Integer sortId 表示時のソートに用いられる ID

• String resourceId リソースアクセス用の ID

• Integer type アイドルのタイプ

  • 1: Princess
  • 2: Fairy
  • 3: Angel
  • 5: Ex

• String fullName アイドルのフルネーム

• String displayName アイドルの表示名

• String lastName アイドルの苗字

  ジュリア、詩花、玲音の場合には "ジュリア"、"詩花"、"玲音" がそれぞれ返ります。

• String|null firstName アイドルの下の名前

  ジュリア、詩花、玲音は null です。

• String alphabetName アイドルのアルファベット表記の名前

• String fullNameRuby アイドルの名前の読み

• Integer|null age アイドルの年齢

  年齢が不明な場合は null になります。

• Object birthplace アイドルの出身地

  • Integer id 出身地の ID

  • String name 出身地の名前

• Object handednessType アイドルの利き手

  • Integer id 利き手の ID

  • String name 利き手

• Float height アイドルの身長

  単位は cm です。不明な場合は 0.0 になります。

• Float weight アイドルの体重

  単位は kg です。不明な場合は 0.0 になります。

• String hobby アイドルの趣味

• String speciality アイドルの特技

• String favorites アイドルの好きなもの

• String cv アイドルの声優

• String colorCode アイドルのパーソナルカラー（サイリウムカラー）のカラーコード

• Object birthday アイドルの誕生日

  誕生日が不明な場合は 0 月 0 日になります。

  • Integer month 月

  • Integer day 日

• Object constellation アイドルの誕生星座

  • Integer id 星座の ID

  • String name 星座の名前

• Object bloodType アイドルの血液型

  • Integer id 血液型の ID

  • String name 血液型

• Object measurements アイドルのスリーサイズ

  単位は cm です。不明な場合は 0.0 になります。

  • Float bust

  • Float waist

  • Float hip

サンプル

https://api.matsurihi.me/api/mltd/v2/idols/21

curl 'https://api.matsurihi.me/api/mltd/v2/idols/21'

レスポンスボディ

{
  "id": 21,
  "sortId": 21,
  "resourceId": "021mat",
  "type": 1,
  "fullName": "徳川 まつり",
  "displayName": "徳川 まつり",
  "lastName": "徳川",
  "firstName": "まつり",
  "alphabetName": "MATSURI TOKUGAWA",
  "fullNameRuby": "とくがわ まつり",
  "age": 19,
  "birthplace": {
    "id": 23,
    "name": "愛知県"
  },
  "handednessType": {
    "id": 1,
    "name": "右"
  },
  "height": 163.0,
  "weight": 44.0,
  "hobby": "漫画あつめ",
  "speciality": "演技",
  "favorites": "焼きマシュマロ、ウミウシ",
  "cv": "諏訪彩花",
  "colorCode": "#5abfb7",
  "birthday": {
    "month": 2,
    "day": 4
  },
  "constellation": {
    "id": 11,
    "name": "水瓶座"
  },
  "bloodType": {
    "id": 4,
    "name": "AB"
  },
  "measurements": {
    "bust": 85.0,
    "waist": 59.0,
    "hip": 85.0
  }
}

GET https://api.matsurihi.me/api/mltd/v2/cards/:cardId

リクエスト

パスパラメータ

• Integer[] cardId カードの ID

  ID を 1 つのみ指定した場合でもレスポンスは配列になります。複数レアリティの存在するカード（周年記念イベントのカードなど）では複数の要素が返ります。v1 とは異なり、ID を指定した場合でもクエリパラメータは有効です。

クエリパラメータ

• Integer[] idolId アイドルの ID
• Enum[] rarity レアリティ

  <Integer> | n | r | sr | ssr

• Enum[] exType カードの種類

  <Integer> | none | pst | pstr | pstp | fes | anniversary | extra | shs

• Boolean includeCostumes 衣装の詳細情報を含める
• Boolean includeParameters パラメータ情報を含める
• Boolean includeLines セリフ情報を含める
• Boolean includeSkills スキル情報を含める
• Boolean includeEvents イベント情報を含める
• String[] orderBy ソート順序

  id | sortId | rarity | idolId | addedAt | id! | sortId! | rarity! | idolId! | addedAt!

  ! を末尾に付けると降順になります。デフォルトは sortId,rarity です。

レスポンス

レスポンスボディ（配列）

• Integer id ID

• String name カード名

• Integer sortId 表示時のソートに用いられる ID

• Integer idolId アイドルの ID

• Integer idolType アイドルのタイプ

  • 1: Princess
  • 2: Fairy
  • 3: Angel
  • 5: Ex

• Integer variation バリエーション（アイドルに対して何番目のカードかを示す値）

• Integer rarity レアリティ

  • 1: N
  • 2: R
  • 3: SR
  • 4: SSR

• String resourceId リソースアクセス用の ID

• Integer exType カードの種類

  • 0: なし
  • 2: PST ランキング報酬
  • 3: PST ポイント報酬
  • 4: フェス限定
  • 5: 1 周年記念イベント報酬
  • 6: Extra カード
  • 7: 2 周年記念イベント報酬
  • 8: Extra PST ランキング報酬
  • 9: Extra PST ポイント報酬
  • 10: 3 周年記念イベント報酬
  • 11: Extra PST ランキング報酬
  • 12: Extra PST ポイント報酬
  • 13: 4 周年記念イベント報酬
  • 14: セカンドヘアスタイル
  • 15: セットなどで販売されたカード
  • 16: 5 周年記念イベント報酬
  • 17: PR カード
  • 18: ミリオンライブ! 10 周年記念イベント報酬
  • 19: 6 周年記念イベント報酬
  • 20: ミリオンリンケージ限定
  • 21: 7 周年記念イベント報酬
  • 22: 8 周年記念イベント報酬

• Integer category カードのカテゴリ

  • 0: カテゴリ未設定
  • 10: ノーマル
  • 20: 恒常ガシャ
  • 21: 期間限定ガシャ
  • 22: フェス限定
  • 24: プレミアムピックアップ SR ガシャ限定
  • 25: セカンドヘアスタイルガシャ限定
  • 26: ミリオンリンケージ限定
  • 30: ミリコレ（SR）
  • 31: イベント報酬カード
  • 32: イベント報酬カード
  • 33: 周年記念イベント報酬カード
  • 34: THE@TER BOOST! 追加カード（「超ビーチバレー[プチキング]　ロコ」など）
  • 35: ミリコレ（R）
  • 36: ミリオンライブ! 周年記念イベント報酬カード
  • 37: THE@TER CHALLENGE!! 追加カード（「アウトサイダー[アイビー]　望月杏奈」など）
  • 41: Ex カード
  • 42: セット販売カード（Ex）
  • 43: 海外版追加カード
  • 44: PR カード
  • 99: その他

• Object costumes 衣装情報

  • Object default デフォルトの衣装

    includeCostume が false の場合には id のみ含まれます。

    • Integer id 衣装 ID

    • Integer sortId? 表示時のソートに用いられる ID

    • String name? 衣装名

    • String description? 衣装の説明

    • String resourceId? リソースアクセス用の ID

    • String modelId? 3D モデルの ID

    • Integer|null costumeGroupId? 衣装グループ ID

      海外版では null になります。

    • Integer|null collaborationNumber? テクスチャバリエーションのある衣装におけるテクスチャの ID

      海外版では null になります。適用されない場合は 0 になります。

    • Integer|null defaultHairstyle? デフォルトのヘアスタイルの ID

      海外版では null になります。

    • Integer|null defaultHairColor? デフォルトのヘアカラーの ID

      海外版では null になります。

    • Boolean|null hasAnotherShader? アナザーシェーダーの有無

      海外版では null になります。

    • Object|null accessory? アクセサリ情報

      海外版では null になります。

      • Integer id アクセサリ ID

      • String resourceId リソースアクセス用の ID

      • Integer default デフォルトの ID

    • DateTime releasedAt? 衣装が追加された日時

  • Object bonus ☆4 ボーナスの衣装

    $.costumes.default と同じ形式です。

  • Object rank5 ☆5 ボーナスの衣装

    $.costumes.default と同じ形式です。

• Integer masterRankMax 最大マスターランク

• Integer skillLvMax 最大スキルレベル

• Object parameters? パラメータ情報

  includeParameters が true の場合にのみ含まれます。

  • Object vocal ボーカルパラメータ

    • Integer base レベル 0 時の値

    • Object beforeAwakened 覚醒前の情報

      • Float diff レベル 1 あたりの増加量

      • Integer max 最大レベルのときの値

    • Object afterAwakened 覚醒後の情報

      $.parameters.vocal.beforeAwakened と同じ形式です。

    • Integer masterBonus マスターランク 1 あたりのボーナス

  • Object dance ダンスパラメータ

    $.parameters.vocal と同じ形式です。

  • Object visual ビジュアルパラメータ

    $.parameters.vocal と同じ形式です。

  • Object lvMax 最大レベル

    • Integer beforeAwakened 覚醒前の最大レベル

    • Integer afterAwakened 覚醒後の最大レベル

  • Object life ライフ

    現在覚醒前後でライフが変化することはありませんが、覚醒前後で個別に返します。

    • Integer beforeAwakened 覚醒前のライフ

    • Integer afterAwakened 覚醒後のライフ

• Object centerEffect? センター効果の情報

  includeSkills が true の場合にのみ含まれます。

  • Integer id センター効果の ID

  • String name センター効果の名前

  • String description センター効果の説明

  • Integer idolType センター効果が適用されるアイドルのタイプ

    • 1: Princess
    • 2: Fairy
    • 3: Angel
    • 4: すべて

  • Integer specificIdolType センター効果が適用される際に全アイドルがあるべきタイプ

    • 0: 制約なし
    • 1: Princess のみ
    • 2: Fairy のみ
    • 3: Angel のみ
    • 4: すべてのタイプを含む

  • Integer songType センター効果が適用されるために必要な楽曲のタイプ

    • 0: なし
    • 1: Princess
    • 2: Fairy
    • 3: Angel

  • Integer[] attributes センター効果が適用されるパラメータ

    • 1: Vocal
    • 2: Dance
    • 3: Visual
    • 4: 全アピール値
    • 5: ライフ
    • 6: スキル発動率
    • 7: ダブルブースト効果量
    • 8: ダブルエフェクト効果量
    • 9: 獲得親愛度

  • Integer[] values センター効果の適用値（パーセント）

• String skillName? スキルの名前

  includeSkills が true の場合にのみ含まれます。

• Object[] skills? スキルの情報

  includeSkills が true の場合にのみ含まれます。スキルは複数取る可能性があるため配列で返ります。

  • Integer id スキルの ID

  • Integer effectId スキル効果の ID

    • 1: スコアアップ
    • 2: コンボボーナス
    • 3: ライフ回復
    • 4: ダメージガード
    • 5: コンボ継続
    • 6: 判定強化
    • 7: ダブルブースト
    • 8: マルチアップ
    • 9: マルチボーナス
    • 10: オーバークロック
    • 11: オーバーロンド
    • 12: ダブルエフェクト
    • 17: フュージョンスコア
    • 18: フュージョンコンボ

  • Integer duration スキルの持続時間（秒）

  • Integer interval スキルの発動間隔（秒）

  • Integer probability スキルの発動確率（スキルレベル 0 時・パーセント）

  • Integer[] evaluationTypes スキルの発動条件

    • 0: すべて
    • 1: Perfect
    • 2: Perfect/Great
    • 3: Great
    • 4: Great/Good/Fast/Slow
    • 5: Perfect/Great/Good
    • 6: Perfect/Great/Good/Fast/Slow
    • 7: Great/Good

  • Integer[] values スキルの効果値

  • String description スキルの説明文

    発動率のプレースホルダは {0} です。

• Object lines? セリフの情報

  includeLines が true の場合にのみ含まれます。プロデューサー名のプレースホルダは {$P$} です。

  • Object flavor フレーバーテキスト

    • String beforeAwakened 覚醒前のフレーバーテキスト

    • String afterAwakened 覚醒後のフレーバーテキスト

  • Object contact ふれあいセリフ

    過去の誤った実装との互換性を保つためフィールド名が奇妙になっていますが無意味です。

    • String beforeAwakened ふれあいセリフ 1 行目

    • String afterAwakened ふれあいセリフ 2 行目

  • String awakening 覚醒セリフ

• DateTime addedAt カードの実装日時

• Object event イベント情報

  includeEvents が指定されていて、カードがイベント報酬の場合にのみ含まれます。形式はイベント API（/api/mltd/v2/events）のレスポンスと同様です。

サンプル

https://api.matsurihi.me/api/mltd/v2/cards?idolId=21&rarity=4

curl 'https://api.matsurihi.me/api/mltd/v2/cards?idolId=21&rarity=4'

レスポンスボディ

[
  {
    "id": 278,
    "name": "ロマンティックランド　徳川まつり",
    "sortId": 278,
    "idolId": 21,
    "idolType": 1,
    "variation": 6,
    "rarity": 4,
    "resourceId": "021mat0064",
    "exType": 0,
    "category": 20,
    "costumes": {
      "default": {
        "id": 30101210
      },
      "bonus": {
        "id": 30101211
      },
      "rank5": {
        "id": 30101212
      }
    },
    "masterRankMax": 5,
    "skillLvMax": 12,
    "addedAt": "2018-05-11T15:00:00+09:00"
  },
  {
    "id": 329,
    "name": "BRAND NEW PERFORMANCE　徳川まつり",
    "sortId": 326,
    "idolId": 21,
    "idolType": 1,
    "variation": 7,
    "rarity": 4,
    "resourceId": "021mat0074",
    "exType": 5,
    "category": 33,
    "costumes": {
      "default": {
        "id": 20104210
      },
      "bonus": {
        "id": 20104211
      }
    },
    "masterRankMax": 4,
    "skillLvMax": 10,
    "addedAt": "2018-06-29T00:00:00+09:00"
  },
  {
    "id": 391,
    "name": "きのこの国のお姫様♪　徳川まつり",
    "sortId": 391,
    "idolId": 21,
    "idolType": 1,
    "variation": 8,
    "rarity": 4,
    "resourceId": "021mat0084",
    "exType": 0,
    "category": 21,
    "costumes": {
      "default": {
        "id": 30102210
      },
      "bonus": {
        "id": 30102211
      },
      "rank5": {
        "id": 30102212
      }
    },
    "masterRankMax": 5,
    "skillLvMax": 10,
    "addedAt": "2018-08-31T15:00:00+09:00"
  }
]

https://api.matsurihi.me/api/mltd/v2/cards/2151?includeCostumes&includeParameters&includeLines&includeSkills&includeEvents

curl 'https://api.matsurihi.me/api/mltd/v2/cards/2151?includeCostumes&includeParameters&includeLines&includeSkills&includeEvents'

レスポンスボディ

[
  {
    "id": 2151,
    "name": "暁天のアステリズム　中谷育",
    "sortId": 2151,
    "idolId": 30,
    "idolType": 1,
    "variation": 43,
    "rarity": 4,
    "resourceId": "030iku0434",
    "exType": 20,
    "category": 26,
    "costumes": {
      "default": {
        "id": 30111300,
        "sortId": 30111300,
        "name": "[ベテルギウス∴KO]中谷育",
        "description": "どんな大人になるんだろう…？\n描く未来には、希望がいっぱい。\nこの夢は、小さくも確かに煌めく\nまだ名もない星たちだけのもの。",
        "resourceId": "030iku0434",
        "modelId": "ss011",
        "costumeGroupId": 0,
        "collaborationNumber": 0,
        "defaultHairstyle": 1,
        "defaultHairColor": 1,
        "hasAnotherShader": true,
        "accessory": {
          "id": 30111300,
          "resourceId": "030iku",
          "default": 2
        },
        "releasedAt": "2023-12-26T15:00:00+09:00"
      },
      "bonus": {
        "id": 30111301,
        "sortId": 30111301,
        "name": "[ベテルギウス∴KO+]中谷育",
        "description": "「ベテルギウス∴KO」の\nアナザー衣装です。",
        "resourceId": "030iku0434_v",
        "modelId": "ss111",
        "costumeGroupId": 0,
        "collaborationNumber": 0,
        "defaultHairstyle": 1,
        "defaultHairColor": 1,
        "hasAnotherShader": true,
        "accessory": {
          "id": 30111301,
          "resourceId": "030iku",
          "default": 2
        },
        "releasedAt": "2023-12-26T15:00:00+09:00"
      }
    },
    "masterRankMax": 4,
    "skillLvMax": 10,
    "parameters": {
      "vocal": {
        "base": 2824,
        "beforeAwakened": {
          "diff": 35.294444444444444,
          "max": 5648
        },
        "afterAwakened": {
          "diff": 39.21604938271605,
          "max": 6353
        },
        "masterBonus": 191
      },
      "dance": {
        "base": 4183,
        "beforeAwakened": {
          "diff": 52.28333333333333,
          "max": 8366
        },
        "afterAwakened": {
          "diff": 58.09259259259259,
          "max": 9411
        },
        "masterBonus": 282
      },
      "visual": {
        "base": 1422,
        "beforeAwakened": {
          "diff": 17.772222222222222,
          "max": 2844
        },
        "afterAwakened": {
          "diff": 19.746913580246915,
          "max": 3199
        },
        "masterBonus": 96
      },
      "lvMax": {
        "beforeAwakened": 80,
        "afterAwakened": 90
      },
      "life": {
        "beforeAwakened": 40,
        "afterAwakened": 40
      }
    },
    "centerEffect": {
      "id": 8005,
      "name": "トリプル・スワイプス",
      "description": "3タイプ編成時、ダンス値が105％アップし、さらにスキル発動率が15%アップ、ダブルブーストの効果量を2％プラス、ダブルエフェクトの効果量を1％プラス",
      "idolType": 4,
      "specificIdolType": 4,
      "songType": 0,
      "attributes": [
        2,
        6,
        7,
        8
      ],
      "values": [
        105,
        15,
        2,
        1
      ]
    },
    "skillName": "小さな星たち",
    "skills": [
      {
        "id": 140,
        "effectId": 1,
        "duration": 5,
        "interval": 9,
        "probability": 40,
        "evaluationTypes": [
          2
        ],
        "values": [
          36
        ],
        "description": "9秒ごとに{0}％の確率で5秒間、Perfect/Greatのスコアが36％アップ"
      }
    ],
    "lines": {
      "flavor": {
        "beforeAwakened": "うどん学園、すっごく楽しかった！\n夕ご飯のうどんもおいしかったし……\n環ちゃん、桃子ちゃん、まだ眠くない？\nわたし、もうすこしだけ\nみんなでおしゃべりしたいなぁ……♪",
        "afterAwakened": "このみさんの歌、大人っぽくてステキ……\nわたしも大人になって恋をしたら、\nこの気持ちがわかるようになるのかなぁ？\n今は、大好きで大切なみんなに……\nわたしたちの歌、届くといいな。"
      },
      "contact": {
        "beforeAwakened": "学校の友達にね、同じクラスの\n男の子のことが好きって\n相談されちゃったんだ…。",
        "afterAwakened": "わたしもいつか、誰かのことを\n好きになったりするのかな。\nうーん、よくわかんないかも…？"
      },
      "awakening": "桃子ちゃん、環ちゃん……ふたりといっしょなら、\nわたしも怖くないよ。ライブ、成功させようね！"
    },
    "addedAt": "2023-12-26T15:00:00+09:00"
  }
]

GET https://api.matsurihi.me/api/mltd/v2/events/:eventId

リクエスト

パスパラメータ

• Integer eventId イベントの ID

クエリパラメータ

• DateTime at その時刻に開催されているイベントの情報を取得する
• Enum[] type イベントの種類

  <Integer> | showtime | millicolle | theater | tour | anniversary | working | aprilfool | gamecorner | twinstage | tune | tale | talkparty | treasure

• String[] orderBy ソート順序

  id | type | beginAt | id! | type! | beginAt!

  末尾に ! を付けると降順になります。デフォルトは beginAt です。

レスポンス

レスポンスボディ（パスパラメータ省略時のみ配列）

• Integer id ID

• Integer type イベントの種類

  • 1: ショータイム
  • 2: ミリコレ!
  • 3: シアター・トラスト
  • 4: ツアー・ツアービンゴ
  • 5: 周年記念イベント
  • 6: ワーキング
  • 7: エイプリルフール
  • 8: ゲームコーナー
  • 9: ミリコレ!（ボックスガシャ）
  • 10: ツインステージ（楽曲別ハイスコア）
  • 11: チューン
  • 12: ツインステージ（合計ハイスコア）
  • 13: テール・タイム・チーム
  • 14: トークパーティー
  • 16: トレジャー

• Integer appealType ボーナスが適用されるアピール値

  • 0: なし
  • 1: ボーカル
  • 2: ダンス
  • 3: ビジュアル

• String name イベントの名前

• Object schedule イベントのスケジュール情報

  • DateTime beginAt イベントの開始日時

  • DateTime endAt イベントの終了日時

  • DateTime pageOpenedAt イベントページの表示開始日時

  • DateTime pageClosedAt イベントページの表示終了日時

  • DateTime|null boostBeginAt 後半戦の開始日時

  • DateTime|null boostEndAt 後半戦の終了日時

• Object item PST イベントなどのアイテム情報

  アイテムの存在しないイベントにもこのフィールドが含まれますが、内容は null になります。

  • String|null name アイテムの名前

  • String|null shortName アイテムの短縮名

• Object cards? 報酬カードの情報

  パスパラメータ指定時のみに含まれます。フォーマットは、すべてのクエリパラメータを指定しない場合のカード API（/api/mltd/v2/cards）と同様です。

サンプル

https://api.matsurihi.me/api/mltd/v2/events?type=4,9

curl 'https://api.matsurihi.me/api/mltd/v2/events?type=4,9'

レスポンスボディ

[
  {
    "id": 181,
    "type": 4,
    "appealType": 0,
    "name": "プラチナスターツアー～ABSOLUTE RUN!!!～",
    "schedule": {
      "beginAt": "2021-04-18T15:00:00+09:00",
      "endAt": "2021-04-26T20:59:59+09:00",
      "pageOpenedAt": "2021-04-18T15:00:00+09:00",
      "pageClosedAt": "2021-04-28T14:59:59+09:00",
      "boostBeginAt": "2021-04-22T15:00:00+09:00",
      "boostEndAt": "2021-04-26T20:59:59+09:00"
    },
    "item": {
      "name": "仲間と繋ぐバトン",
      "shortName": "バトン"
    }
  },
  {
    "id": 184,
    "type": 9,
    "appealType": 0,
    "name": "ミリコレ！～MILLIONLIVE COLLECTION～",
    "schedule": {
      "beginAt": "2021-05-11T15:00:00+09:00",
      "endAt": "2021-05-16T20:59:59+09:00",
      "pageOpenedAt": "2021-05-11T15:00:00+09:00",
      "pageClosedAt": "2021-05-18T14:59:59+09:00",
      "boostBeginAt": null,
      "boostEndAt": null
    },
    "item": {
      "name": null,
      "shortName": null
    }
  }
]

https://api.matsurihi.me/api/mltd/v2/events/212

curl 'https://api.matsurihi.me/api/mltd/v2/events/212'

レスポンスボディ

{
  "id": 212,
  "type": 11,
  "appealType": 1,
  "name": "プラチナスターチューン～ミラージュ・ミラー～",
  "schedule": {
    "beginAt": "2021-11-30T15:00:00+09:00",
    "endAt": "2021-12-08T20:59:59+09:00",
    "pageOpenedAt": "2021-11-30T15:00:00+09:00",
    "pageClosedAt": "2021-12-10T14:59:59+09:00",
    "boostBeginAt": "2021-12-04T15:00:00+09:00",
    "boostEndAt": "2021-12-08T20:59:59+09:00"
  },
  "item": {
    "name": "すずらんの花束",
    "shortName": "花束"
  },
  "cards": [
    {
      "id": 1354,
      "name": "鏡の中のあなた　エミリー",
      "sortId": 1354,
      "idolId": 32,
      "idolType": 1,
      "variation": 30,
      "rarity": 3,
      "resourceId": "032emi0303",
      "exType": 2,
      "category": 31,
      "costumes": {
        "default": {
          "id": 40225320
        },
        "bonus": {
          "id": 40225321
        }
      },
      "masterRankMax": 4,
      "skillLvMax": 10,
      "addedAt": "2021-11-30T15:00:00+09:00"
    },
    {
      "id": 1355,
      "name": "鏡の中のあなた　徳川まつり",
      "sortId": 1355,
      "idolId": 21,
      "idolType": 1,
      "variation": 30,
      "rarity": 3,
      "resourceId": "021mat0303",
      "exType": 3,
      "category": 31,
      "costumes": {},
      "masterRankMax": 4,
      "skillLvMax": 10,
      "addedAt": "2021-11-30T15:00:00+09:00"
    }
  ]
}

GET https://api.matsurihi.me/api/mltd/v2/events/:eventId/rankings/borders

リクエスト

パスパラメータ

• Integer eventId イベントの ID

レスポンス

レスポンスボディ

• Integer[] eventPoint? イベント pt ランキング

• Integer[] highScore? ハイスコアランキング

• Integer[] highScore2? ハイスコアランキング（2 曲目・ツインステージのみ）

• Integer[] highScoreTotal? 合計ハイスコアランキング（チューンなど）

• Integer[] loungePoint? ラウンジランキング

• Object[] idolPoint? アイドル別ランキング

  • Integer idolId アイドルの ID

  • Integer[] borders 報酬ボーダーのポイント

    10 位以内限定の称号が追加された「私たちの R@inbow!」以降とそれ以前のイベントでは異なります。

サンプル

https://api.matsurihi.me/api/mltd/v2/events/192/rankings/borders

curl 'https://api.matsurihi.me/api/mltd/v2/events/192/rankings/borders'

レスポンスボディ

{
  "eventPoint": [
    100,
    2500,
    5000,
    10000,
    25000,
    50000,
    100000
  ],
  "highScore": [
    100,
    2000,
    5000,
    10000,
    20000
  ],
  "loungePoint": [
    10,
    50,
    100,
    250,
    500
  ],
  "idolPoint": [
    {
      "idolId": 21,
      "borders": [
        100,
        1000
      ]
    },
    {
      "idolId": 22,
      "borders": [
        100,
        1000
      ]
    }
  ]
}

GET https://api.matsurihi.me/api/mltd/v2/events/:eventId/rankings/borderPoints

リクエスト

パスパラメータ

• Integer eventId イベントの ID

リクエストヘッダ

• String If-None-Match

レスポンス

レスポンスヘッダ

• String ETag

レスポンスボディ

• Object eventPoint? イベント pt ランキング

  • Object scores ボーダーのスコアの一覧

    • Integer rank 順位

    • Integer score スコア

  • DateTime aggregatedAt ランキングの集計日時

  • DateTime updatedAt? ランキングの更新日時

    ランキング発表時刻が不明な場合にはこのフィールドは存在しません。

  • Integer count ランキング参加人数

• Object highScore? ハイスコアランキング

  フォーマットは $.eventPoint と同じです。

• Object highScore2? ハイスコアランキング（2 曲目・ツインステージのみ）

  フォーマットは $.eventPoint と同じです。

• Object highScoreTotal? 合計ハイスコアランキング（チューンなど）

  フォーマットは $.eventPoint と同じです。

• Object loungePoint? ラウンジランキング

  フォーマットは $.eventPoint と同じです。

• Object[] idolPoint? アイドル別ランキング

  アイドル別ランキングのみ、ランキング参加人数が含まれません。

  • Integer idolId アイドルの ID

  • Object scores ボーダーのスコアの一覧

    • Integer rank 順位

    • Integer score スコア

  • DateTime aggregatedAt ランキングの集計日時

  • DateTime updatedAt? ランキングの更新日時

    ランキング発表時刻が不明な場合にはこのフィールドは存在しません。

サンプル

https://api.matsurihi.me/api/mltd/v2/events/192/rankings/borderPoints

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/192/rankings/borderPoints'

レスポンスヘッダ

• ETag: "c10c461d47c21e417ca4f458f692a0f0"

レスポンスボディ

{
  "eventPoint": {
    "scores": [
      {
        "rank": 1,
        "score": 7970172
      },
      {
        "rank": 2,
        "score": 7962705
      },
      {
        "rank": 3,
        "score": 7949841
      }
    ],
    "aggregatedAt": "2021-07-12T00:30:00+09:00",
    "updatedAt": "2021-07-12T12:00:14+09:00",
    "count": 159417
  },
  "idolPoint": [
    {
      "idolId": 21,
      "scores": [
        {
          "rank": 1,
          "score": 7532366
        },
        {
          "rank": 2,
          "score": 7487553
        },
        {
          "rank": 3,
          "score": 7364562
        },
        {
          "rank": 100,
          "score": 2354702
        },
        {
          "rank": 1000,
          "score": 579411
        }
      ],
      "aggregatedAt": "2021-07-12T00:30:00+09:00",
      "updatedAt": "2021-07-12T12:00:04+09:00"
    }
  ]
}

https://api.matsurihi.me/api/mltd/v2/events/192/rankings/borderPoints

リクエストヘッダ

• If-None-Match: "c10c461d47c21e417ca4f458f692a0f0"

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/192/rankings/borderPoints' \
  -H 'If-None-Match: "c10c461d47c21e417ca4f458f692a0f0"'

ステータスコード: 304 Not Modified

レスポンスヘッダ

• ETag: "c10c461d47c21e417ca4f458f692a0f0"

GET https://api.matsurihi.me/api/mltd/v2/events/:eventId/rankings/:type/summaries

リクエスト

パスパラメータ

• Integer eventId イベントの ID
• Enum type ランキングの種類

  eventPoint | highScore | highScore2 | highScoreTotal | loungePoint

リクエストヘッダ

• String If-None-Match

レスポンス

レスポンスヘッダ

• String ETag

レスポンスボディ（配列）

• Integer count ランキング参加人数

• DateTime aggregatedAt 集計時刻

• DateTime updatedAt? 更新時刻

  ランキング発表時刻が不明な場合にはこのフィールドは存在しません。

サンプル

https://api.matsurihi.me/api/mltd/v2/events/212/rankings/eventPoint/summaries

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/212/rankings/eventPoint/summaries'

レスポンスヘッダ

• ETag: "09de5b28ae3ac9b715876ed07a8dc457"

レスポンスボディ

[
  {
    "count": 9016,
    "aggregatedAt": "2021-11-30T15:30:00+09:00",
    "updatedAt": "2021-11-30T15:35:00+09:00"
  },
  {
    "count": 13439,
    "aggregatedAt": "2021-11-30T16:00:00+09:00",
    "updatedAt": "2021-11-30T16:06:00+09:00"
  },
  {
    "count": 16242,
    "aggregatedAt": "2021-11-30T16:30:00+09:00",
    "updatedAt": "2021-11-30T16:36:00+09:00"
  }
]

https://api.matsurihi.me/api/mltd/v2/events/212/rankings/eventPoint/summaries

リクエストヘッダ

• If-None-Match: "09de5b28ae3ac9b715876ed07a8dc457"

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/212/rankings/eventPoint/summaries' \
  -H 'If-None-Match: "09de5b28ae3ac9b715876ed07a8dc457"'

ステータスコード: 304 Not Modified

レスポンスヘッダ

• ETag: "09de5b28ae3ac9b715876ed07a8dc457"

GET https://api.matsurihi.me/api/mltd/v2/events/:eventId/rankings/idolPoint/:idolId/summaries

リクエスト

パスパラメータ

• Integer eventId イベントの ID
• Integer idolId アイドルの ID

クエリパラメータ

• Boolean all 指定すると 30 分ごとに間引かずにすべてのデータを取得します

リクエストヘッダ

• String If-None-Match

レスポンス

レスポンスヘッダ

• String ETag

レスポンスボディ（配列）

• DateTime aggregatedAt 集計時刻

• DateTime updatedAt? 更新時刻

  ランキング発表時刻が不明な場合にはこのフィールドは存在しません。

サンプル

https://api.matsurihi.me/api/mltd/v2/events/192/rankings/idolPoint/21/summaries

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/192/rankings/idolPoint/21/summaries'

レスポンスヘッダ

• ETag: "5a07c2b93dd2e0c742e7ab54f3a58f94"

レスポンスボディ

[
  {
    "aggregatedAt": "2021-06-29T00:30:00+09:00",
    "updatedAt": "2021-06-29T00:31:04+09:00"
  },
  {
    "aggregatedAt": "2021-06-29T01:00:00+09:00",
    "updatedAt": "2021-06-29T01:01:34+09:00"
  },
  {
    "aggregatedAt": "2021-06-29T01:30:00+09:00",
    "updatedAt": "2021-06-29T01:31:04+09:00"
  },
  {
    "aggregatedAt": "2021-06-29T02:00:00+09:00",
    "updatedAt": "2021-06-29T02:01:35+09:00"
  }
]

https://api.matsurihi.me/api/mltd/v2/events/192/rankings/idolPoint/21/summaries

リクエストヘッダ

• If-None-Match: "5a07c2b93dd2e0c742e7ab54f3a58f94"

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/192/rankings/idolPoint/21/summaries' \
  -H 'If-None-Match: "5a07c2b93dd2e0c742e7ab54f3a58f94"'

ステータスコード: 304 Not Modified

レスポンスヘッダ

• ETag: "5a07c2b93dd2e0c742e7ab54f3a58f94"

GET https://api.matsurihi.me/api/mltd/v2/events/:eventId/rankings/:type/logs/:ranks

リクエスト

パスパラメータ

• Integer eventId イベントの ID
• Enum type ランキングの種類

  eventPoint | highScore | highScore2 | highScoreTotal | loungePoint

• Integer[] ranks 取得する順位のリスト

クエリパラメータ

• DateTime since 取得するログの開始時刻

  このクエリパラメータを指定すると、その時刻以降のデータのみ返します。指定した時刻のデータは含まれません。

リクエストヘッダ

• String If-None-Match

レスポンス

レスポンスヘッダ

• String ETag

レスポンスボディ（配列）

• Integer rank 順位

• Object[] data ランキングのログ

  • Integer score スコア

  • DateTime aggregatedAt ランキングの集計日時

サンプル

https://api.matsurihi.me/api/mltd/v2/events/212/rankings/eventPoint/logs/1

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/212/rankings/eventPoint/logs/1'

レスポンスヘッダ

• ETag: "a205260df8ddd3cc363f5d7b97d64a6d"

レスポンスボディ

[
  {
    "rank": 1,
    "data": [
      {
        "score": 5754,
        "aggregatedAt": "2021-11-30T15:30:00+09:00"
      },
      {
        "score": 10920,
        "aggregatedAt": "2021-11-30T16:00:00+09:00"
      },
      {
        "score": 16674,
        "aggregatedAt": "2021-11-30T16:30:00+09:00"
      },
      {
        "score": 21840,
        "aggregatedAt": "2021-11-30T17:00:00+09:00"
      }
    ]
  }
]

https://api.matsurihi.me/api/mltd/v2/events/212/rankings/eventPoint/logs/1

リクエストヘッダ

• If-None-Match: "a205260df8ddd3cc363f5d7b97d64a6d"

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/212/rankings/eventPoint/logs/1' \
  -H 'If-None-Match: "a205260df8ddd3cc363f5d7b97d64a6d"'

ステータスコード: 304 Not Modified

レスポンスヘッダ

• ETag: "a205260df8ddd3cc363f5d7b97d64a6d"

GET https://api.matsurihi.me/api/mltd/v2/events/:eventId/rankings/idolPoint/:idolId/logs/:ranks

リクエスト

パスパラメータ

• Integer eventId イベントの ID
• Integer idolId アイドルの ID
• Integer[] ranks 取得する順位のリスト

クエリパラメータ

• DateTime since 取得するログの開始時刻

  このクエリパラメータを指定すると、その時刻以降のデータのみ返します。指定した時刻のデータは含まれません。

• Boolean all 指定すると 30 分ごとに間引かずにすべてのデータを取得します

リクエストヘッダ

• String If-None-Match

レスポンス

レスポンスヘッダ

• String ETag

レスポンスボディ（配列）

• Integer rank 順位

• Object[] data ランキングのログ

  • Integer score スコア

  • DateTime aggregatedAt ランキングの集計日時

サンプル

https://api.matsurihi.me/api/mltd/v2/events/192/rankings/idolPoint/21/logs/1

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/192/rankings/idolPoint/21/logs/1'

レスポンスヘッダ

• ETag: "aef5c2e813c96fd099bd9ef7a92abaa0"

レスポンスボディ

[
  {
    "rank": 1,
    "data": [
      {
        "score": 13888,
        "aggregatedAt": "2021-06-29T00:30:00+09:00"
      },
      {
        "score": 40782,
        "aggregatedAt": "2021-06-29T01:00:00+09:00"
      },
      {
        "score": 53640,
        "aggregatedAt": "2021-06-29T01:30:00+09:00"
      },
      {
        "score": 79416,
        "aggregatedAt": "2021-06-29T02:00:00+09:00"
      }
    ]
  }
]

https://api.matsurihi.me/api/mltd/v2/events/192/rankings/idolPoint/21/logs/1

リクエストヘッダ

• If-None-Match: "aef5c2e813c96fd099bd9ef7a92abaa0"

curl --include 'https://api.matsurihi.me/api/mltd/v2/events/192/rankings/idolPoint/21/logs/1' \
  -H 'If-None-Match: "aef5c2e813c96fd099bd9ef7a92abaa0"'

ステータスコード: 304 Not Modified

レスポンスヘッダ

• ETag: "aef5c2e813c96fd099bd9ef7a92abaa0"

GET https://api.matsurihi.me/api/mltd/v2/votes/:id

リクエスト

パスパラメータ

• Integer id 投票イベントの ID

レスポンス

レスポンスボディ（パスパラメータ省略時のみ配列）

• Integer id ID

• Integer voteSystemType 投票形式

  • 1: 必須
  • 2: 任意

• Object event イベント情報

  形式はイベント API（/api/mltd/v2/events）のレスポンスと同様です。

サンプル

https://api.matsurihi.me/api/mltd/v2/votes

curl 'https://api.matsurihi.me/api/mltd/v2/votes'

レスポンスボディ

[
  {
    "id": 2,
    "voteSystemType": 2,
    "event": {
      "id": 382,
      "type": 4,
      "appealType": 0,
      "name": "プラチナスターツアービンゴ～Clash of Colors～",
      "schedule": {
        "beginAt": "2025-05-18T15:00:00+09:00",
        "endAt": "2025-05-25T20:59:59+09:00",
        "pageOpenedAt": "2025-05-18T15:00:00+09:00",
        "pageClosedAt": "2025-05-27T14:59:59+09:00",
        "boostBeginAt": "2025-05-22T15:00:00+09:00",
        "boostEndAt": "2025-05-25T20:59:59+09:00"
      },
      "item": {
        "name": "飛び交う歌声",
        "shortName": "歌声"
      }
    }
  }
]

GET https://api.matsurihi.me/api/mltd/v2/votes/:id/rankings/logs

リクエスト

パスパラメータ

• Integer id 投票イベントの ID

レスポンス

レスポンスボディ（配列）

• DateTime aggregatedAt ランキングの集計日時

• DateTime updatedAt ランキングの発表日時

• Object[] ranking その集計日時現在のランキング

  • Integer candidateId 投票先 ID

  • Integer rank 順位

  • Integer votedRate 得票率［%］

    2025/10/21 01:10 までの集計ではデータが欠損しています（固定値として 0 が返ります）。

  • Integer point 得票数

    得票数が直接利用されないイベントでは -1 になることがあります。

サンプル

https://api.matsurihi.me/api/mltd/v2/votes/2/rankings/logs

curl 'https://api.matsurihi.me/api/mltd/v2/votes/2/rankings/logs'

レスポンスボディ

[
  {
    "aggregatedAt": "2025-05-18T23:05:00+09:00",
    "updatedAt": "2025-05-18T23:10:00+09:00",
    "ranking": [
      {
        "candidateId": 5,
        "rank": 1,
        "votedRate": 0,
        "point": 1210631
      },
      {
        "candidateId": 3,
        "rank": 2,
        "votedRate": 0,
        "point": 1090030
      },
      {
        "candidateId": 4,
        "rank": 3,
        "votedRate": 0,
        "point": 1018694
      },
      {
        "candidateId": 6,
        "rank": 4,
        "votedRate": 0,
        "point": 984359
      }
    ]
  },
  {
    "aggregatedAt": "2025-05-18T23:10:00+09:00",
    "updatedAt": "2025-05-18T23:11:00+09:00",
    "ranking": [
      {
        "candidateId": 5,
        "rank": 1,
        "votedRate": 0,
        "point": 1225089
      },
      {
        "candidateId": 3,
        "rank": 2,
        "votedRate": 0,
        "point": 1099963
      },
      {
        "candidateId": 4,
        "rank": 3,
        "votedRate": 0,
        "point": 1028169
      },
      {
        "candidateId": 6,
        "rank": 4,
        "votedRate": 0,
        "point": 992130
      }
    ]
  }
]

https://api.matsurihi.me/api/mltd/v2/votes/5/rankings/logs

curl 'https://api.matsurihi.me/api/mltd/v2/votes/5/rankings/logs'

レスポンスボディ

[
  {
    "aggregatedAt": "2025-10-21T01:15:00+09:00",
    "updatedAt": "2025-10-21T01:17:01+09:00",
    "ranking": [
      {
        "candidateId": 16,
        "rank": 1,
        "votedRate": 40,
        "point": -1
      },
      {
        "candidateId": 17,
        "rank": 2,
        "votedRate": 30,
        "point": -1
      },
      {
        "candidateId": 15,
        "rank": 3,
        "votedRate": 30,
        "point": -1
      }
    ]
  },
  {
    "aggregatedAt": "2025-10-21T01:20:00+09:00",
    "updatedAt": "2025-10-21T01:21:00+09:00",
    "ranking": [
      {
        "candidateId": 16,
        "rank": 1,
        "votedRate": 40,
        "point": -1
      },
      {
        "candidateId": 17,
        "rank": 2,
        "votedRate": 30,
        "point": -1
      },
      {
        "candidateId": 15,
        "rank": 3,
        "votedRate": 30,
        "point": -1
      }
    ]
  }
]

GET https://api.matsurihi.me/api/mltd/v2/lounges

リクエスト

クエリパラメータ

• String name ラウンジの名前

  2 文字以上で指定してください。大文字小文字を無視します。

レスポンス

レスポンスボディ（配列）

サンプル

https://api.matsurihi.me/api/mltd/v2/lounges?name=徳川まつり

curl 'https://api.matsurihi.me/api/mltd/v2/lounges?name=%E5%BE%B3%E5%B7%9D%E3%81%BE%E3%81%A4%E3%82%8A'

GET https://api.matsurihi.me/api/cgss/v2/version/latest

レスポンス

レスポンスボディ

• Object app アプリのバージョン情報

  • String version バージョン

  • DateTime updatedAt 強制アップデート日時

• Object asset アセットのバージョン情報

  • Integer version バージョン

  • DateTime updatedAt 配信日時

サンプル

https://api.matsurihi.me/api/cgss/v2/version/latest

curl 'https://api.matsurihi.me/api/cgss/v2/version/latest'

レスポンスボディ

{
  "app": {
    "version": "8.4.0",
    "updatedAt": "2022-12-07T12:01:00+09:00"
  },
  "asset": {
    "version": 10102310,
    "updatedAt": "2022-12-09T17:13:00+09:00"
  }
}

GET https://api.matsurihi.me/api/cgss/v2/version/apps/:version

リクエスト

パスパラメータ

• String version バージョン

  バージョンを指定しない場合、レスポンスはすべてのバージョンの配列になります。

レスポンス

レスポンスボディ（パスパラメータ省略時のみ配列）

• String version バージョン

• DateTime updatedAt 強制アップデート日時

サンプル

https://api.matsurihi.me/api/cgss/v2/version/apps

curl 'https://api.matsurihi.me/api/cgss/v2/version/apps'

レスポンスボディ

[
  {
    "version": "3.8.8",
    "updatedAt": "2018-05-09T12:00:00+09:00"
  },
  {
    "version": "3.8.9",
    "updatedAt": "2018-06-14T12:04:00+09:00"
  },
  {
    "version": "3.9.0",
    "updatedAt": "2018-06-22T12:04:00+09:00"
  },
  {
    "version": "3.9.1",
    "updatedAt": "2018-07-19T15:28:00+09:00"
  }
]

https://api.matsurihi.me/api/cgss/v2/version/apps/4.0.0

curl 'https://api.matsurihi.me/api/cgss/v2/version/apps/4.0.0'

レスポンスボディ

{
  "version": "4.0.0",
  "updatedAt": "2018-07-30T12:03:00+09:00"
}

GET https://api.matsurihi.me/api/cgss/v2/version/assets/:version

リクエスト

パスパラメータ

• Integer version バージョン

  バージョンを指定しない場合、レスポンスはすべてのバージョンの配列になります。

レスポンス

レスポンスボディ（パスパラメータ省略時のみ配列）

• Integer version バージョン

• DateTime updatedAt 配信日時

サンプル

https://api.matsurihi.me/api/cgss/v2/version/assets

curl 'https://api.matsurihi.me/api/cgss/v2/version/assets'

レスポンスボディ

[
  {
    "version": 10038700,
    "updatedAt": "2018-05-08T14:54:00+09:00"
  },
  {
    "version": 10038710,
    "updatedAt": "2018-05-08T20:03:00+09:00"
  },
  {
    "version": 10038800,
    "updatedAt": "2018-05-10T14:54:00+09:00"
  }
]

https://api.matsurihi.me/api/cgss/v2/version/assets/10100000

curl 'https://api.matsurihi.me/api/cgss/v2/version/assets/10100000'

レスポンスボディ

{
  "version": 10100000,
  "updatedAt": "2022-09-23T15:00:00+09:00"
}

GET https://api.matsurihi.me/api/cgss/v2/derepo/statuses/:statusId

リクエスト

パスパラメータ

• Integer statusId 投稿の ID

クエリパラメータ

• Integer idolId アイドルの ID

  アイドルの ID は Starlight DB の URL のパスパラメータで確認できます。

• Integer groupId スレッドの ID
• Integer hashtagId ハッシュタグの ID
• DateTime until 投稿日時の上限

  このパラメータで指定された日時を含みません。

• DateTime since 投稿日時の下限

  このパラメータで指定された日時を含みます。

• Integer limit 取得する投稿の数

  1 から 100 の範囲で指定できます。デフォルトは 10 です。

• Enum orderBy ソート順

  postedAt | id | postedAt! | id!

  ! を付けると降順になります。デフォルト: postedAt!

レスポンス

レスポンスボディ（パスパラメータ省略時のみ配列）

• Integer id 投稿の ID

• Integer groupId スレッドの ID

• Integer groupOrder スレッド内の投稿の順序

• Integer idolId アイドルの ID

• String name 投稿時の名前

  アイドルの名前ではなく投稿時の名前を返します。

• String message 投稿の本文

  HTML として表示されるテキストをそのまま返すため、<br> などのマークアップ文字列がそのまま含まれます。スタンプの投稿の場合には、stamp_only:stampId の形式の特殊な本文が返ります。

• String iconPath

• String|null imagePath

• DateTime postedAt 投稿日時

• Object[] hashtags ハッシュタグ

  • Integer id ハッシュタグの ID

  • String hashtag ハッシュタグの文字列

• Object stamp? スタンプの情報

  • String id スタンプの ID

  • String name スタンプの名前

    matsurihi.me 側で決定した非公式の名前を含みます。

サンプル

https://api.matsurihi.me/api/cgss/v2/derepo/statuses?limit=5&until=2022-12-15T18:48:00+09:00

curl 'https://api.matsurihi.me/api/cgss/v2/derepo/statuses?limit=5&until=2022-12-15T18:48:00+09:00'

レスポンスボディ

[
  {
    "id": 23489,
    "groupId": 7470,
    "groupOrder": 5,
    "idolId": 127,
    "name": "前川みく",
    "message": "stamp_only:stamp_000092",
    "iconPath": "7f2f2e676abb3c722e75984d18f27e43",
    "imagePath": null,
    "postedAt": "2022-12-15T18:47:00+09:00",
    "hashtags": [],
    "stamp": {
      "id": "stamp_000092",
      "name": "オラァ！"
    }
  },
  {
    "id": 23488,
    "groupId": 7470,
    "groupOrder": 4,
    "idolId": 154,
    "name": "安部菜々",
    "message": "美味しそうですねぇ♪",
    "iconPath": "2c0885cd5a23ae4fe8afdc20f0c4b836",
    "imagePath": null,
    "postedAt": "2022-12-15T18:43:00+09:00",
    "hashtags": []
  },
  {
    "id": 23487,
    "groupId": 7470,
    "groupOrder": 3,
    "idolId": 178,
    "name": "多田李衣菜",
    "message": "みくちゃんがお魚を…！",
    "iconPath": "41b54cbf88ce23e6389666aefda8aed7",
    "imagePath": null,
    "postedAt": "2022-12-15T18:41:00+09:00",
    "hashtags": []
  },
  {
    "id": 23486,
    "groupId": 7470,
    "groupOrder": 2,
    "idolId": 192,
    "name": "浅利七海",
    "message": "ふわふわ♪おいしい♪<br>お魚ハンバーグ♪",
    "iconPath": "2adcb8cf61115b7a739110f79f8b6d15",
    "imagePath": null,
    "postedAt": "2022-12-15T18:37:00+09:00",
    "hashtags": []
  },
  {
    "id": 23485,
    "groupId": 7470,
    "groupOrder": 1,
    "idolId": 192,
    "name": "浅利七海",
    "message": "ハンバーグ♪<br>ハンバーグ♪",
    "iconPath": "2adcb8cf61115b7a739110f79f8b6d15",
    "imagePath": "f8aeecb8ce20f1ff9db85463995b4c4c",
    "postedAt": "2022-12-15T18:36:00+09:00",
    "hashtags": [
      {
        "id": 1642,
        "hashtag": "晩ごはん！"
      }
    ]
  }
]

GET https://api.matsurihi.me/api/cgss/v2/derepo/hashtags

レスポンス

レスポンスボディ（配列）

• Integer id ハッシュタグの ID

• String hashtag ハッシュタグの文字列

サンプル

https://api.matsurihi.me/api/cgss/v2/derepo/hashtags

curl 'https://api.matsurihi.me/api/cgss/v2/derepo/hashtags'

レスポンスボディ

[
  {
    "id": 1001,
    "hashtag": "LIVEステージ裏"
  },
  {
    "id": 1002,
    "hashtag": "役作り"
  },
  {
    "id": 1003,
    "hashtag": "みんなでオフ !"
  }
]

GET https://api.matsurihi.me/api/cgss/v2/derepo/stamps

レスポンス

レスポンスボディ（配列）

• String id スタンプの ID

• String name スタンプの名前

サンプル

https://api.matsurihi.me/api/cgss/v2/derepo/stamps

curl 'https://api.matsurihi.me/api/cgss/v2/derepo/stamps'

レスポンスボディ

[
  {
    "id": "stamp_000001",
    "name": "がんばります！"
  },
  {
    "id": "stamp_000002",
    "name": "全力で行くよ"
  },
  {
    "id": "stamp_000003",
    "name": "ファイト！"
  }
]

GET https://api.matsurihi.me/c/v1/version/latest

レスポンス

レスポンスボディ

• Object script スクリプトのバージョン情報

  • Integer version バージョン

  • DateTime updateTime 配信日時

• Object asset アセットのバージョン情報

  • Integer version バージョン

  • DateTime updateTime 配信日時

サンプル

https://api.matsurihi.me/sc/v1/version/latest

curl 'https://api.matsurihi.me/sc/v1/version/latest'

レスポンスボディ

{
  "script": {
    "version": 269,
    "updateTime": "2022-12-09T12:04:58+09:00"
  },
  "asset": {
    "version": 225,
    "updateTime": "2022-12-09T19:02:45+09:00"
  }
}

GET https://api.matsurihi.me/sc/v1/events/fanRanking

レスポンス

レスポンスボディ（配列）

• Integer id ハッシュタグの ID

• String name イベント名

• DateTime beginTime イベント開始日時

• DateTime endTime イベント終了日時

サンプル

https://api.matsurihi.me/sc/v1/events/fanRanking

curl 'https://api.matsurihi.me/sc/v1/events/fanRanking'

レスポンスボディ

[
  {
    "id": 40005,
    "name": "2.5Anniversaryプロデューサーズカップ",
    "beginTime": "2020-10-12T15:00:00+09:00",
    "endTime": "2020-10-21T11:59:59+09:00"
  },
  {
    "id": 40006,
    "name": "3rd Anniversaryプロデューサーズカップ",
    "beginTime": "2021-04-12T15:00:00+09:00",
    "endTime": "2021-04-20T11:59:59+09:00"
  },
  {
    "id": 40007,
    "name": "3.5Anniversaryプロデューサーズカップ",
    "beginTime": "2021-10-12T15:00:00+09:00",
    "endTime": "2021-10-18T11:59:59+09:00"
  },
  {
    "id": 40008,
    "name": "4th Anniversaryプロデューサーズカップ",
    "beginTime": "2022-04-11T15:00:00+09:00",
    "endTime": "2022-04-17T11:59:59+09:00"
  },
  {
    "id": 40009,
    "name": "4.5Anniversaryプロデューサーズカップ",
    "beginTime": "2022-10-11T15:00:00+09:00",
    "endTime": "2022-10-16T11:59:59+09:00"
  }
]

GET https://api.matsurihi.me/sc/v1/events/fanRanking/:eventId/rankings/logs/:characterId/:ranks

リクエスト

パスパラメータ

• Integer eventId イベントの ID
• Integer characterId アイドルの ID
  • 1: 櫻木真乃
  • 2: 風野灯織
  • 3: 八宮めぐる
  • 4: 月岡恋鐘
  • 5: 田中摩美々
  • 6: 白瀬咲耶
  • 7: 三峰結華
  • 8: 幽谷霧子
  • 9: 小宮果穂
  • 10: 園田智代子
  • 11: 西城樹里
  • 12: 杜野凛世
  • 13: 有栖川夏葉
  • 14: 大崎甘奈
  • 15: 大崎甜花
  • 16: 桑山千雪
  • 17: 芹沢あさひ
  • 18: 黛冬優子
  • 19: 和泉愛依
  • 20: 浅倉透
  • 21: 樋口円香
  • 22: 福丸小糸
  • 23: 市川雛菜
  • 24: 七草にちか
  • 25: 緋田美琴
  • 26: 斑鳩ルカ
• Integer[] ranks 取得する順位のリスト

レスポンス

レスポンスボディ（配列）

• Integer rank 順位

• Object[] data ランキングのログ

  • Integer score スコア

  • DateTime summaryTime ランキングの集計日時

サンプル

https://api.matsurihi.me/sc/v1/events/fanRanking/40005/rankings/logs/1/1,2,3

curl 'https://api.matsurihi.me/sc/v1/events/fanRanking/40005/rankings/logs/1/1,2,3'

レスポンスボディ

[
  {
    "rank": 1,
    "data": [
      {
        "score": 10232976,
        "summaryTime": "2020-10-12T16:00:00+09:00"
      },
      {
        "score": 19265458,
        "summaryTime": "2020-10-12T16:30:00+09:00"
      },
      {
        "score": 23650324,
        "summaryTime": "2020-10-12T17:00:00+09:00"
      }
    ]
  },
  {
    "rank": 2,
    "data": [
      {
        "score": 10080470,
        "summaryTime": "2020-10-12T16:00:00+09:00"
      },
      {
        "score": 16423491,
        "summaryTime": "2020-10-12T16:30:00+09:00"
      },
      {
        "score": 20916404,
        "summaryTime": "2020-10-12T17:00:00+09:00"
      }
    ]
  },
  {
    "rank": 3,
    "data": [
      {
        "score": 9999826,
        "summaryTime": "2020-10-12T16:00:00+09:00"
      },
      {
        "score": 16311059,
        "summaryTime": "2020-10-12T16:30:00+09:00"
      },
      {
        "score": 18641723,
        "summaryTime": "2020-10-12T17:00:00+09:00"
      }
    ]
  }
]