Cinderella API v2 [ @imcgborder REST API ]

めくるめく　あざやかなMEMORIES　EVERLASTING

デレマスボーダーbotの情報を外部で活用したい開発者のみなさまへ、 API を提供しています。

目次一覧：

  1. Cinderella API の仕様について
  2. 全API共通
  3. イベント関係 API
  4. プロデューサー関係 API
  5. プロダクション関係 API
  6. アイドル・カード関係 API
  7. 道場関係 API
  8. フリートレード履歴関係 API

このドキュメントは、Cinderella API v2 の仕様を説明しています。2020年8月まで利用されていた古い API である、Cinderella API v1 のドキュメントはこちら です。現在は、新規利用では必ず v2 を利用してください。

Cinderella API の仕様について

Cinderella APIとは

デレマスボーダーbotのデータをAPIの形で提供しています。

外部アプリ（Webアプリ、TwitterやDiscordなどの各種bot、各種デスクトップアプリなど）で、デレマスボーダーbotと同等のデータを利用することができます。

共通仕様

  1. デレマスボーダーbotが保有していない（欠けている）データはなにをどうやっても出力できません。Webポータルで表示されないデータは API でも出てきません。
  2. JSON 形式のみ対応しています。デフォルトでは整形された JSON を提供します。 pretty=false をクエリーとして付与すると、非整形の状態で提供され、より高速になります。
  3. 成否の判断は常に HTTP ステータスコードで返却されます。 4xx/5xx はすべてエラーです。
  4. 短時間に高速のリクエストを行うか、または応答データ量の大きいリクエストを複数回行った場合、 429 [Too Many Requests] が返却されます。応答完了後、5秒の wait を挟むことを推奨します。
  5. パラメータの型に ? が付与されているものは任意値を表します。
  6. レスポンスにおける ? はその型が nullable であることを表します。ただし、string は常に nullable です。
  7. パラメータの型に [] が付与されているものは配列を表します。パラメータでは半角カンマ (,) 区切りで付与してください。例：?systemId=1,2,3
  8. DateTime 型は ISO8601 拡張形式 (2024-04-19T14:00:21+09:00) で記載すると確実に解釈します。+ は %2B でURLエンコードする必要があるかもしれません。タイムゾーンを省略した場合、原則として JST(+09:00) で認識されます。
  9. APIごとの Limit の記載は、API ごとの、1アクセスにおける最大応答件数の制限を示します。たとえば、2000が設定されている場合は最大でも2000件しか JSON 出力されません。
    要求条件によっては、出力されている以上の件数が実データとしては存在する場合があります。この場合、応答の totalCount には実データとして存在する件数、outputCount には JSON で出力した件数が設定されます。つまり totalCount > outputCount なら取得漏れを起こしています。
  10. パラメータに破壊的変更が入った場合は URL のバージョンを変更する予定です（保証はしません）。ただし、送受信いずれのパラメータも、項目追加は破壊的変更に含みません。新たな値が増える想定で実装することをおすすめします。

イベントIDの考え方

デレマスボーダーbotは、総合ランキングと中間ランキングを表現するため、独自の ID 体系（内部ID）を持っています。

【例】真実の強さを纏う公演 テイルズ オブ シンデリア2
モバゲーイベントID
(MobageEventId)		 イベント基本ID
(EventInfoId)		 イベント明細ID
(EventDetailId)		 種別
1926 270 262 総合ランキング
263 中間ランキング

IDは「イベント情報」で取得してください。パラメータ指定時は、イベント基本IDまたはイベント明細IDでの問い合わせが必要な場合があります。

利用規定 (留意事項)

  1. Cinderella API（以下、APIと記載）を利用して公開サービスを作成・運用する場合は、その取得元がデレマスボーダーbot(@imcgborder)であることを明記してください。
  2. API の仕様変更、障害、運用終了等により、サービスに支障が生じた場合でも、デレマスボーダーbotはいかなる責も負いません。
  3. API の動作状況や送信内容にかかわらず、サービスの利用者からの問い合わせがデレマスボーダーbotに直接送られることがないよう明示的にしなければなりません。利用者からの問い合わせはサービス運営者が対応することを明記するか、もしくは（サービス運営者が利用者がそれを行わない場合は）デレマスボーダーbotに対しても問い合わせをしないよう明記してください。API に関する問い合わせは、サービス運営者が必ず集約したうえで、必要に応じて Twitter:@imcgborder へ連絡をお願いします。
  4. 特定のプロデューサー・プロダクションの晒し上げや、特定アイドルを担当しているプロデューサーが不快になる可能性が考えられる用途において、データを利用することはご遠慮ください。
  5. 上記に記載のない内容は、デレマスボーダーbotの利用規定に準じます。

全API共通

全API共通フォーマット

すべてのAPIはこの共通フォーマットとともに提供されます。

レスポンスデータ

  • int statusCode 応答したステータスコード（APサーバ停止時はこのコードが返却されませんので、エラー判定には HTTP ヘッダの値を利用してください）
  • bool isSuccess データ取得処理の成功時にtrue
  • bool deprecated APIが非推奨、または非推奨となったパラメータが含まれる要求時にtrue
  • string message メッセージ（エラーメッセージなど）
  • int totalCount パラメータにマッチした件数
  • int outputCount contentで出力した件数（API の Limit によっては、totalCount より少ない場合があります）
  • object[] content 出力内容（各APIの個別仕様を参照してください）

デレマスボーダーbot 内部コード [GET] /v2/codes

Limit なし

API の要求・応答で用いるキーは、この API で説明を含めて提供しています。
以下のドキュメントで「コードカテゴリ」と記載している場合は、コード毎の意味がこの API に掲載されています。
ex. https://api.pink-check.school/v2/codes

レスポンスデータ

  • string categoryKey コードカテゴリ
  • string explanation コードカテゴリの説明
  • string parentCategoryKey 親コードカテゴリ
  • object[] detail コード明細
    • int codeValue コード値／数値キー。ほとんどの API の要求・応答ではこの値を用います。
    • string stringValue コード値／文字列キー。カードレアリティなど、一部のコードで用います。
    • string producerName プロデューサー名
    • int? parentCodeValue 親コード値
    • string shortExplanation 説明(短縮形)
    • string explanation 説明
    • string remarks 備考

備考

  • codeValue は、同一 categoryKey において一意 (unique) です。
  • stringValue は、同一 categoryKey において一意 (unique) です。

イベント関係 API

イベント情報 [GET] /v2/events/[eventInfoId?]

Limit なし

ex.
https://api.pink-check.school/v2/events/
https://api.pink-check.school/v2/events/279

パスパラメータ

  • int? eventInfoId イベント基本情報ID（mobageEventId/name と同時指定不可）

クエリパラメータ

  • int? mobageEventId モバゲーイベントID（eventInfoId/name と同時指定不可）
  • string? name イベント名（部分一致検索。eventInfoId/mobageEventId と同時指定不可）
  • int? eventTypeId イベント種別ID※
  • DateTime? time 指定された時間に開催中のイベントを取得

レスポンスデータ

  • int eventInfoId イベント基本情報ID
  • int mobageEventId モバゲーイベントID
  • string name イベント名
  • string shortName イベント名 (ボーダーbot内で使用されている省略表記版)
  • int eventTypeId イベント種別ID (コードカテゴリ：EventTypeId)
  • string eventTypeName イベント種別名
  • bool isReprint 復刻イベント
  • object[] detail イベント明細
    • int eventDetailId イベント明細ID
    • int sequence シーケンス
    • int eventDetailTypeId イベント明細種別ID (コードカテゴリ：EventDetailTypeId)
    • string explanation 明細説明
    • DateTime beginDateTime イベント開始日時
    • DateTime endDateTime イベント終了日時
    • DateTime finalRankingDateTime ランキング公開日時
    • string cardHash 上位報酬カードハッシュ
    • string cardName 上位報酬カード名
    • int take2CardRank 2枚取りの最低順位
    • int take1CardRank 1枚取りの最低順位
    • int orgRewardRankingTypeId 団体上位報酬の入賞種別 (コードカテゴリ：RankingTypeId)
    • int orgRewardBorderRank 団体入賞報酬がもらえる団体の順位
    • int orgRewardMembers 団体の最大構成人数
    • string remark 備考
  • object[] timeTable イベント明細
    • int eventTimeTypeId イベントタイムテーブル種別ID
    • DateTime begin 開始日時
    • DateTime end 終了日時
  • object[] abilityCard イベントパワー発揮カード
    • string cardHash カードハッシュ
    • string cardName カード名
    • decimal scale パワー倍率

備考

  • abilityCard は、EventInfoId が 279 以降にのみデータが存在します。

イベント順位情報 [GET] /v2/eventdetails/[eventDetailId]/rankings/points

Limit なし

ex. https://api.pink-check.school/v2/eventdetails/369/rankings/points
ex. https://api.pink-check.school/v2/eventdetails/369/rankings/points?rank=1,2,3,4,5&rankingTypeId=1

パスパラメータ

  • int eventDetailId イベント明細ID

クエリパラメータ

  • int[]? rank 取得対象順位（100件まで指定可能。all/targetId と同時指定不可）
  • bool? all 全順位取得（未指定または false 指定時は100位、200位、2000位などの基準順位のみ。rank/targetId と同時指定不可）
  • int[]? systemId 取得対象のモバゲーIDまたはプロダクションID（100件まで指定可能。rank/all と同時指定不可）
  • int? rankingTypeId イベント順位種別ID（コードカテゴリ：RankingTypeId。rank/targetId 指定時は必須）
  • DateTime? time 対象観測日時（rank/all/rank いずれかを指定した場合は、毎時0分のみ指定可）

レスポンスデータ

  • DateTime time 日時
  • object[] ranking ランキング
    • int rankingTypeId イベント順位種別ID (コードカテゴリ：RankingTypeId)
    • int rank 順位
    • long point イベントpt
    • int? systemId モバゲーIDまたはプロダクションID（ミニチームの場合は null）
    • string name ユーザ・プロダクション名
    • string leaderCardHash リーダーカードハッシュ
    • long gainPointTenMinByRank 増加ポイント(10分速/順位による)
    • long gainPointHalfHourByRank 増加ポイント(30分速/順位による)
    • long gainPointOneHourByRank 増加ポイント(時速/順位による)
    • long gainPointOneDayByRank 増加ポイント(24時間速/順位による)
    • long gainPointTenMinBySystemId 増加ポイント(10分速/システムIDによる)
    • long gainPointHalfHourBySystemId 増加ポイント(30分速/システムIDによる)
    • long gainPointOneHourBySystemId 増加ポイント(時速/システムIDによる)
    • long gainPointOneDayBySystemId 増加ポイント(24時間速/システムIDによる)

備考

  • パラメータで順位を指定しない場合、基準順位（個人200位、2000位など）のみを出力します。
  • all 指定時に time を指定していない場合、直近の0分の情報が取得されます。
  • イベント期間中は基準順位＋個人2000位より上のプロデューサーのptを観測しています。イベント終了後に、最終結果の全順位を取得します。したがって、常にすべての順位を取得できるわけではありませんし、イベント最終時刻とそれ以前では取得可能な順位が異なります。
  • 更新されるタイミングは、基準順位は10分毎の更新後1分以内、それ以外の順位は6分以内が目処です。通常よりモバゲー側が応答に時間を要しているような場合は、基準順位以外の更新をしない（取得をやめる）ことがあります。
  • TBSなどの受取ptがあるイベントの場合、毎ラウンド最終時刻においては取得処理全体が20分遅延されます。
  • time を指定しない場合、毎時0分のみ出力されます。毎時0分以外の値が必要な場合は、その都度 time を指定してください。time の指定時は rank/all/rank は指定できません。
  • 中間・最終ランキングの種別にかかわらず、イベント終了時刻のスコア取得は最終ランキング公開日時に実行されます。また、プロデューサーおよびプロダクションの全順位はイベント終了後36時間後に取得されます。
  • 補正などの影響で実データと若干の差が出る場合があります。本データは、必ずしも正確ではありません。

イベントポイント増加量 [GET] /v2/events/gainpoints

Limit なし

ex. https://api.pink-check.school/v2/events/gainpoints?eventDetailId=394
ex. https://api.pink-check.school/v2/events/gainpoints?rankingTypeId=1&systemId=62160821

クエリパラメータ

  • int? eventDetailId イベント明細ID
  • int? rankingTypeId イベント順位種別ID（コードカテゴリ：RankingTypeId。targetId 指定時は必須）
  • int[]? systemId 取得対象のモバゲーIDまたはプロダクションID（100件まで指定可能）

レスポンスデータ

  • DateTime time 日時
  • object[] ranking ランキング
    • int eventDetailId イベント明細ID
    • int rankingTypeId イベント順位種別ID (コードカテゴリ：RankingTypeId)
    • int systemId 取得対象のモバゲーIDまたはプロダクションID
    • long? maxGainPointTenMin イベント内で観測した最大の増加ポイント(10分速)
    • long? maxGainPointHalfHour イベント内で観測した最大の増加ポイント(30分速)
    • long? maxGainPointOneHour イベント内で観測した最大の増加ポイント(時速)
    • long? maxGainPointOneDay イベント内で観測した最大の増加ポイント(24時間速)
    • DateTime? maxGainPointTenMinTime イベント内で最大の増加ポイントを観測した終端の日時(10分速)
    • DateTime? maxGainPointHalfHourTime イベント内で最大の増加ポイントを観測した終端の日時(30分速)
    • DateTime? maxGainPointOneHourTime イベント内で最大の増加ポイントを観測した終端の日時(時速)
    • DateTime? maxGainPointOneDayTime イベント内で最大の増加ポイントを観測した終端の日時(24時間速)
    • long? avgRunningGainPointTenMin イベント内での走行時平均ポイント増加量(10分速)
    • long? avgRunningGainPointHalfHour イベント内での走行時平均ポイント増加量(30分速)
    • long? avgRunningGainPointOneHour イベント内での走行時平均ポイント増加量(時速)
    • long? avgRunningGainPointOneDay イベント内での走行時平均ポイント増加量(24時間速)
    • int totalActimeTime イベント内での合計走行時間(分)。1ptでも増加していることが推測できた回数、10分を最小単位として合計したもの。

備考

  • eventDetailId または systemId いずれかは指定必須です。
  • 30分速/時速/24時間速は、それぞれの n 分前のポイントデータが存在しない場合、n 分前以降のもっとも古いポイントを始端とみなして計測します。たとえば、イベント開始日の15:40の時速は、15:00を起点として計算されます。
  • 補正などの影響で実データと若干の差が出る場合があります。本データは、必ずしも正確ではありません。
  • 2019年1月を含めそれ以前の観測データが不十分なため、計測が不正確です。

イベント最終ポイント [GET] /v2/events/lastpoints

Limit なし

ex. https://api.pink-check.school/v2/events/lastpoints?rankingTypeId=1&systemId=62160821
ex. https://api.pink-check.school/v2/events/lastpoints?rankingTypeId=2&systemId=176

クエリパラメータ

  • int rankingTypeId イベント順位種別ID（コードカテゴリ：RankingTypeId。必須）
  • int systemId 取得対象のモバゲーIDまたはプロダクションID（必須）

レスポンスデータ

  • int eventDetailId イベント明細ID
  • int rankingTypeId イベント順位種別ID (コードカテゴリ：RankingTypeId)
  • int systemId 取得対象のモバゲーIDまたはプロダクションID
  • bool exists 結果の存在有無
  • int? rank 順位
  • long? point イベントpt
  • string name ユーザ・プロダクション名
  • string leaderCardHash リーダーカードハッシュ

備考

  • exists は、ボーダーbot内の結果保持の有無です。false の場合、rank 以降はすべて null となります。
  • leaderCardHash は、古いデータには存在しない（nullの）場合があります。

ミュージックJAM スーパーLIVE情報 分析結果 [GET] /v2/events/jam/analyze/[eventInfoId]

Limit 1

ex. https://api.pink-check.school/v2/events/jam/analyze/359

クエリパラメータ

  • int eventInfoId イベント基本情報ID（ミュージックJAMのみが指定可能）

レスポンスデータ

  • int superLiveNumber スーパーLIVE通し番号
  • int percent スーパーLIVEゲージ(%)
  • bool isUnderSuperLive スーパーLIVE開催中
  • DateTime observedTime 最終観測日時
  • string untilNextSuperLiveTime 次のスーパーLIVEまでの予想時間 (hh:mm:ss.ffffff)

備考

  • superLiveNumber は、ゲージ0%～100%（スーパーLIVE開催）までを1サイクルとした、eventInfoId 内でのサイクル通し番号です。
  • eventInfoId は 359 を含め、それ以降のみデータが存在します。

ミュージックJAM スーパーLIVE情報 観測履歴 [GET] /v2/events/jam/progress/[eventInfoId]

Limit なし

ex. https://api.pink-check.school/v2/events/jam/progress/359

クエリパラメータ

  • int eventInfoId イベント基本情報ID（ミュージックJAMのみが指定可能）
  • bool? onlySuperLive スーパーLIVE開催中（isUnderSuperLive = true）のみを取得

レスポンスデータ

  • int eventInfoId イベント基本情報ID
  • int superLiveNumber スーパーLIVE通し番号
  • int sequqnce superLiveNumber 内でのシーケンス番号
  • int percent スーパーLIVEゲージ(%)
  • bool isUnderSuperLive スーパーLIVE開催中
  • DateTime observedTime 観測日時

備考

  • superLiveNumber は、ゲージ0%～100%（スーパーLIVE開催）までを1サイクルとした、eventInfoId 内でのサイクル通し番号です。
  • eventInfoId、superLiveNumber、sequqnce で一意となります。
  • eventInfoId、superLiveNumber、percent でも一意となります。ただし、 mobage 側の仕様により、観測日時が大きいにも関わらず、percent が小さくなることがあります。したがって、確実に時間順を取得する場合は sequqnce を使用してください。
  • eventInfoId は 359 を含め、それ以降のみデータが存在します。

プロデューサー関係 API

プロデューサー検索 [GET] /v2/producers/[mobageId?]

Limit 2000

ex. https://api.pink-check.school/v2/producers/62160821
ex. https://api.pink-check.school/v2/producers?producerName=C

パスパラメータ

  • int? mobageId モバゲーID（producerName/productionId との同時指定不可）

クエリパラメータ

  • string? producerName ユーザ名（前方一致。mobageId/productionId との同時指定不可）
  • int? productionId プロダクションID（mobageId/producerName との同時指定不可）
  • DateTime? beginUpdateTimestamp 更新日時(自) （endUpdateTimestampの指定必須）
  • DateTime? endUpdateTimestamp 更新日時(至) （beginUpdateTimestampの指定必須）

レスポンスデータ

  • int mobageId モバゲーID
  • int? productionId 所属プロダクションID
  • string productionName 所属プロダクション名
  • string unitName ユニット名
  • int? katagakiId 肩書ID
  • string producerName プロデューサー名
  • int producerRank プロデューサーランク (コードカテゴリ：Rank)
  • long fans ファン数
  • string leaderCardHash リーダーアイドルハッシュ
  • int? leaderIdolId リーダーアイドルID
  • string leaderCardName リーダーアイドル名
  • int level レベル
  • string classification 属性 (コードカテゴリ：Classification)
  • int battle LIVEバトル回数
  • int victory LIVEバトル勝利数
  • int album アルバム写真数
  • int shinaiMax 親愛度MAX人数
  • string favorite1CardHash ホシイモノ1カードハッシュ
  • string favorite1CardName ホシイモノ1カード名
  • string favorite2CardHash ホシイモノ2カードハッシュ
  • string favorite2CardName ホシイモノ2カード名
  • string favorite3CardHash ホシイモノ3カードハッシュ
  • string favorite3CardName ホシイモノ3カード名
  • DateTime updateTimestamp 更新日時

備考

  • mobageId/producerName/productionId/beginUpdateTimestamp いずれかは必須です。
  • このAPIで検索できるプロデューサー情報は、ボーダーbotが現在把握している最新情報のみです。プロデューサーごとの過去の明細は、プロデューサー明細情報を使用して取得してください。
  • ホシイモノ1～3は、設定されているものがアイドルの場合のみ表示されます。スタドリなどのアイテムの場合は空白またはnullとなります。

プロデューサー明細情報 [GET] /v2/producers/[mobageId]/details

Limit なし

ex. https://api.pink-check.school/v2/producers/62160821/details

パスパラメータ

  • int mobageId モバゲーID

レスポンスデータ

  • int eventDetailId イベント明細ID
  • int? mobageId モバゲーID
  • int? productionId 所属プロダクションID
  • string productionName 所属プロダクション名
  • string unitName ユニット名
  • int? katagakiId 肩書ID
  • string producerName プロデューサー名
  • int? producerRank プロデューサーランク (コードカテゴリ：Rank)
  • long fans ファン数
  • string leaderCardHash リーダーアイドルハッシュ
  • int? leaderIdolId リーダーアイドルID
  • string leaderCardName リーダーアイドル名
  • int level レベル
  • string classification 属性 (コードカテゴリ：Classification)
  • int battle LIVEバトル回数
  • int victory LIVEバトル勝利数
  • int album アルバム写真数
  • int shinaiMax 親愛度MAX人数
  • string favorite1CardHash ホシイモノ1カードハッシュ
  • string favorite1CardName ホシイモノ1カード名
  • string favorite2CardHash ホシイモノ2カードハッシュ
  • string favorite2CardName ホシイモノ2カード名
  • string favorite3CardHash ホシイモノ3カードハッシュ
  • string favorite3CardName ホシイモノ3カード名
  • int eventRank イベント最終順位
  • long eventPoint イベント最終pt

備考

  • 現在開催中の順位・スコアは表示されません。
  • ユーザが参加していないイベントの明細は表示されません。
  • ホシイモノ1～3は、設定されているものがアイドルの場合のみ表示されます。スタドリなどのアイテムの場合は空白/nullとなります。

プロデューサー年間集計結果 [GET] /v2/producers/[mobageId]/annuals

Limit なし

ex. https://api.pink-check.school/v2/producers/62160821/annuals

パスパラメータ

  • int mobageId モバゲーID

レスポンスデータ

  • int year 年
  • int? mobageId モバゲーID
  • string producerName プロデューサー名
  • string mostDeployedLeaderCardHash 最も配置したリーダーカードハッシュ★
  • int? mostDeployedLeaderIdolId 最も配置したリーダーアイドルID★
  • int eventJoinCount 参加回数
  • int rankInCount 入賞回数(1枚以上)
  • int top10Count 10位入賞回数
  • int take2Count 最終2枚取り入賞回数
  • int take1Count 最終1枚取り入賞回数
  • int UpperRank1Count 最終1位以上
  • int UpperRank10Count 最終10位以上
  • int UpperRank100Count 最終100位以上
  • int UpperRank200Count 最終200位以上
  • int UpperRank1000Count 最終1000位以上
  • int UpperRank2000Count 最終2000位以上
  • int UpperRank4000Count 最終4000位以上
  • int UpperRank7000Count 最終7000位以上
  • int midRank 順位中央値（参加したイベントのみ）
  • int avgRank 順位平均値（参加したイベントのみ）
  • int rankInIntermediateCount 中間イベント入賞回数
  • DateTime? beginObservedDateTime 始端観測日時★ (その年で始めて参加したイベント)
  • int? beginProducerRank 始端プロデューサーランク★
  • int? beginFans 始端ファン数★
  • int? beginLevel 始端レベル★
  • int? beginBattle 始端LIVEバトル回数★
  • int? beginVictory 始端LIVEバトル勝利数★
  • int? beginAlbum 始端アルバム写真数★
  • int? beginShinaiMax 始端親愛度MAX人数★
  • DateTime? endObservedDateTime 終端観測日時★
  • int? endProducerRank 終端プロデューサーランク★
  • int? endFans 終端ファン数★
  • int? endLevel 終端レベル★
  • int? endBattle 終端LIVEバトル回数★
  • int? endVictory 終端LIVEバトル勝利数★
  • int? endAlbum 終端アルバム写真数★
  • int? endShinaiMax 終端親愛度MAX人数★
  • int? incrementalProducerRank 増分プロデューサーランク★
  • int? incrementalFans 増分ファン数★
  • int? incrementalLevel 増分レベル★
  • int? incrementalBattle 増分LIVEバトル回数★
  • int? incrementalVictory 増分LIVEバトル勝利数★
  • int? incrementalAlbum 増分アルバム写真数★
  • int? incrementalShinaiMax 増分親愛度MAX人数★

備考

  • プロデューサーの年間イベント参加・入賞結果の集計を示します。
  • ★が付与されているレスポンスは、年に2回以上イベントに参加した場合にのみ値が設定されます。(ここでのイベントへの参加とは1pt以上を取得することを指す)
  • プロデューサーが参加していないイベントの明細は表示されません。

プロダクション関係 API

プロダクション検索 [GET] /v2/productions/[productionId?]

Limit 2000

ex. https://api.pink-check.school/v2/productions/309761
ex. https://api.pink-check.school/v2/productions?producerName=A

パスパラメータ

  • int? productionId モバゲーID（producerName との同時指定不可）

クエリパラメータ

  • string? producerName プロダクション名（前方一致。productionId との同時指定不可）
  • DateTime? beginUpdateTimestamp 更新日時(自) （endUpdateTimestampの指定必須）
  • DateTime? endUpdateTimestamp 更新日時(至) （beginUpdateTimestampの指定必須）

レスポンスデータ

  • int productionId プロダクションID
  • string productionName プロダクション名
  • int? productionRank プロダクションランク (コードカテゴリ：Rank)
  • long fans ファン数
  • int level レベル
  • int development 発展度
  • long development 増資マニー
  • int representProducerId 代表プロデューサーID
  • string representProducerName 代表プロデューサー名
  • int members 社員数
  • bool esthe エステルーム
  • bool cafe カフェテラス
  • bool sauna サウナルーム
  • string comment コメント
  • DateTime updateTimestamp 更新日時

備考

  • productionId/productionName/beginUpdateTimestamp いずれかは必須です。
  • このAPIで検索できるプロダクション情報は、ボーダーbotが現在把握している最新情報のみです。プロダクションごとの過去の明細は、プロダクション明細情報を使用して取得してください。

プロダクション明細情報 [GET] /v2/productions/[productionId]/details

Limit なし

ex. https://api.pink-check.school/v2/productions/309761/details

パスパラメータ

  • int productionId プロダクションID

レスポンスデータ

  • int eventDetailId イベント明細ID
  • int? productionId プロダクションID
  • string productionName プロダクション名
  • int productionRank プロダクションランク (コードカテゴリ：Rank)
  • long fans ファン数
  • int level レベル
  • int development 発展度
  • long money 増資マニー
  • int? representProducerId 代表プロデューサーID
  • string representProducerName 代表プロデューサー名
  • int members 社員数
  • bool esthe エステルーム
  • bool cafe カフェテラス
  • bool sauna サウナルーム
  • string comment コメント
  • int eventRank イベント最終順位
  • long eventPoint イベント最終pt

備考

  • ミニチームイベント場合、このAPIでは情報が出力されません。
  • 所属しているプロダクションメンバーが1名も参加していない（＝プロダクションのポイントが 0 の）イベントの明細は表示されません。

アイドル・カード関係 API

アイドル [GET] /v2/idols/[idolId?]

Limit なし

ex. https://api.pink-check.school/v2/idols

パスパラメータ

  • int? idolId アイドルID

レスポンスデータ

  • int idolId アイドルID (ボーダーbot内部ID)
  • string name アイドル名
  • string yomi 読み方（ひらがな）
  • string classification 属性 (コードカテゴリ：Classification)
  • int birthdayMonth 誕生日(月)
  • int birthdayDate 誕生日(日)
  • int age 年齢
  • string constellation 星座
  • string bloodGroup 血液型
  • string handedness 利き手
  • string originPlace 出生地
  • string hobby 趣味
  • string characterVoice 声優

カード [GET] /v2/cards/[cardHash?]

Limit なし

ex.https://api.pink-check.school/v2/cards
ex.https://api.pink-check.school/v2/cards/abbe52ff16730a445dd85e701907925c

パスパラメータ

  • string? cardHash カードハッシュ（32桁。cardMobageId/idolId との同時指定不可）

クエリパラメータ

  • int? cardMobageId カードモバゲーID (Mobage上でのカードID) （cardHash/idolId との同時指定不可）
  • int? idolId アイドルID（cardHash/cardMobageId との同時指定不可）

レスポンスデータ

  • string cardHash カードハッシュ
  • int cardMobageId カードモバゲーID (Mobage上でのカードID)
  • int idolId アイドルID (ボーダーbot内部ID)
  • string rality レアリティ (コードカテゴリ：Rality)
  • string name カード名
  • string aliasName カード別名（ex. [ﾙﾐﾅｽｽﾀｰ]北条加蓮(2020)における[ﾙﾐﾅｽｽﾀｰ]北条加蓮）
  • string prefix カードプレフィクス
  • bool isPlus 特訓後の場合 true
  • string height 身長
  • string weight 体重
  • string bustSize バストサイズ
  • string waistSize ウエストサイズ
  • string hipSize ヒップサイズ
  • int cost コスト
  • int defaultAttack 初期攻
  • int defaultDefence 初期守
  • string abilityName 特技名
  • object? abilityEffect 特技効果
  • object? doubleAbilityEffect ダブル特技効果
  • bool growIdol アイプロ育成アイドル
  • bool freeTradeLimited フリートレード制限中
  • int? currentTradeNormalPrice 直近価格(通常)
  • int? currentTradePremiumPrice 直近価格(プレミアムサイン付き)
  • int? currentPriceDiffNormalAndPremium プレミアムサイン付きと通常の直近価格差
  • bool? isUnderOneDrinkIdol マニーでの取引が全体の 1/4 以上
  • decimal? avgTradePrice 平均価格(全体)
  • decimal? avgTradeNormalPrice 平均価格(通常)
  • decimal? avgTradePremiumPrice 平均価格(プレミアムサイン付き)
  • decimal? tradePriceDiffNormalAndPremium プレミアムサイン付きと通常の平均価格差
  • decimal? tradeEnastaRatio 直近エナ/スタ比
  • decimal? tradeDailyFrequency 1日あたり約定回数

備考

  • 登録直後のカードは取得できないことがあります。
  • 現在開催中のイベントの上位報酬SRは取得できません。配布後に登録されます。
  • フリートレードの価格関連機能は、直近50件のトレードを解析した結果です。すべての「価格」はスタドリ換算です。
  • フリートレードの価格関連機能は、10分ごとのバッチ処理で計算されています。ほかのフリートレード関連の結果とは情報が一致しない場合があります。

道場関係 API

道場 [GET] /v2/dojos

Limit なし

ex. https://api.pink-check.school/v2/dojos

クエリパラメータ

  • int? minLevel 最低レベル（200～400）
  • int? maxLevel 最高レベル（200～400）
  • int? minRank 最低プロデューサーランク（コードカテゴリ：Rank）
  • int? maxRank 最高プロデューサーランク（コードカテゴリ：Rank）

レスポンスデータ

  • int mobageId モバゲーID
  • int dojoStatusId 道場ステータスID（営業中：10、休業：80、廃業：90）
  • DateTime registDateTime 道場登録日時
  • DateTime lastUpdate 最終更新日時
  • int level レベル
  • int producerRank プロデューサーランク (コードカテゴリ：Rank)
  • string producerName プロデューサー名
  • int? productionId プロダクションID
  • string productionName プロダクション名
  • string leaderCardHash リーダーアイドルハッシュ
  • string leaderCardName リーダーアイドル名
  • int? defaultDefence リーダーアイドル初期守
  • string unitName ユニット名
  • string comment コメント

備考

  • レベル200未満の道場はボーダーbotでは取り扱いません。
  • 道場のクロール間隔期待値は通常18時間毎です。ただし、イベントの終了後(通常23時)からイベント最終結果発表の36時間後までの間は、最終結果取得処理を優先するためクロールが行われません。
  • dojoStatusIdは、ユニット名やコメントに「休業」「おやすみ」などの文言が含まれていると休業と判定されます。

フリートレード履歴関係 API

フリートレード履歴 [GET] /v2/trades/[cardHash?]

Limit 2000

ex.https://api.pink-check.school/v2/trades/3815832491e393399209a0b9ae0e56ef
ex.https://api.pink-check.school/v2/trades/?beginTime=2020-08-01T00:00:00+09:00&endTime=2020-08-04T12:00:00+09:00

パスパラメータ

  • string? cardHash トレード対象カード（32桁）　※送り元が宛先に送るカードを指します。

クエリパラメータ

  • DateTime? beginTime 検索対象のトレード日時(自) （endTimeの指定必須）
  • DateTime? endTime 検索対象のトレード日時(至) （beginTimeの指定必須）
  • string? sourceProducerName 送り元プロデューサー名
  • string? destProducerName 宛先プロデューサー名
  • int? eventCardAbility パワー持ちカード検索条件 (コードカテゴリ：CardAbilitySearchCondition)
  • int? eventInfoId パワー持ちカード検索対象イベント基本ID（eventCardAbilityの指定必須。省略時は開催中の最新のイベントになります）

レスポンスデータ

  • int mobageTradeHistoryDetailId モバゲーフリートレード明細ID
  • string cardHash トレード対象カードハッシュ
  • string cardName トレード対象カード名
  • DateTime tradeTime トレード日時
  • bool isPremium トレード対象カードがプレミアムサイン付か
  • string sourceProducerName 送り元プロデューサー名
  • string destProducerName 宛先プロデューサー名
  • object[] item トレードアイテム　※送り元がトレード希望内容として登録したものです。最大5件まで設定されます。
    • int sequence トレードアイテム設定番号
    • int itemTypeId アイテム種別ID (コードカテゴリ：ItemTypeId)
    • int? volume 取引量（アイテム数量、またはマニーの数）
    • string cardHash カードハッシュ
    • string cardName カード名

備考

  • eventInfoId は、279 以降を指定した場合のみ機能します。

カード別フリートレード履歴 [GET] /v2/trades/daily/[cardHash?]

ex.https://api.pink-check.school/v2/trades/daily/29f6687479f7e7ead423d615fb9dfbed
ex.https://api.pink-check.school/v2/trades/daily/?targetTime=2021-07-01T00:00:00+09:00

パスパラメータ

  • string? cardHash トレード対象カード（32桁）

クエリパラメータ

  • DateTime? targetTime 対象日（日付のみ有効であり、時間を設定しても無視されます）

レスポンスデータ

  • string cardHash カードハッシュ
  • DateTime targetDate 対象日
  • int currentTradeNormalPrice フリートレード直近価格(スタドリ換算)
  • int? currentTradePremiumPrice フリートレード直近価格(スタドリ換算/プレミアムサイン付き)
  • decimal avgTradePrice フリートレード平均価格(スタドリ)
  • decimal? avgTradeNormalPrice フリートレード平均価格(スタドリ/プレミアムサインなし)
  • decimal? avgTradePremiumPrice フリートレード平均価格(スタドリ/プレミアムサイン付き)
  • int todayTradeCount 当日取引回数
  • int todayTradeNormalCount 当日取引回数(通常)
  • int todayTradePremiumCount 当日取引回数(プレミアムサイン)

備考

  • cardHash または targetTime いずれかは指定必須です。
  • cardHash にフリートレード制限中のカードを設定することはできません。
  • フリートレード平均価格は、当日終了時点までの直近50トレードの平均価格を指します。