NAV Navbar

ようこそ

みずはのめAPI v1は現在、以下のエンドポイントから提供されています

https://v2.mizuhanome.net/api/v1/

みずはのめAPIv1は現在、開発中です。以下のことをご了承のうえ、ご利用ください:

セッション

認証

以下のようなPOSTリクエストでメールアドレスとアクセスキーを送信します:

export email=yourMailAddress
export accessKey=yourAccessKey
curl -X POST "https://v2.mizuhanome.net/api/v1/authenticate?email=$email&accessKey=$accessKey"

認証成功時、以下のようなJSONが帰ります:

{
  "status": "success",
  "message": "認証しました",
  "session": "mySessionKey",
  "expiredAt": 1539365293333
}

APIキーセッションmySessionKeyを以降のAPI利用時に使用します

export session=mySessionKey

APIキーをお持ちでない場合、APIキーの作成から、あたらしいAPIキーを作成します。

セッションの更新

以下のようなPOSTリクエストを送信します:

curl -X POST "https://v2.mizuhanome.net/api/v1/refresh?session=$session"

更新が完了すると、以下のようなJSONが帰ります:

{
  "status": "success",
  "expiredAt": 1539368410718
}

expiredAtはUnixTimeを1000で掛けたものです)

date -r $((1539368410718/1000))
# 2018年 10月13日 土曜日 03時20分10秒 JST

作成したセッションは1時間で失効します、これを再度1時間に延長します。

セッションの破棄

以下のようなPOSTリクエストを送信します:

curl -X POST "https://v2.mizuhanome.net/api/v1/destroy?session=$session"

破棄が完了すると、以下のようなJSONが帰ります:

{
  "status": "success"
}

指定したセッションを即座に破棄します

HTTP Request

POST https://v2.mizuhanome.net/api/v1/destroy

みんなの予想

投稿する

{
  "tickets": [
    {
      "numbers": [
        {
          "numberset": "123"
        }
      ]
    }
  ]
}

上記のようなPOSTデータが最小の投稿情報です、以下のように送信します:

curl -X POST "https://v2.mizuhanome.net/api/v1/forecasts/201810130601?session=$session"
  -H "Content-Type: application/json"
  -d '{"tickets":[{"numbers":[{"numberset":"123"}]}]}'

投稿成功時、以下のようなJSONが帰ります:

{
  "status": "success",
  "url": "/forecasts/31",
  "data": {
    "id": 31,
    "dataid": 201810130601,
    "note": "",
    "bet": 100,
    "price": 0,
    "tickets": [
      {
        "type": "3t",
        "mode": "single",
        "numbersets": "1-2-3",
        "bet": 100,
        "numbers": [
          {
            "numberset": "123",
            "bet": 100
          }
        ]
      }
    ]
  }
}

また、以下のように複数の券を購入したり、一部の組番だけ賭け金を変更したい場合は、以下のようにデータを追記します:

{
  "headline": "テスト予想",
  "note": "1はモーターを交換した\n2はA1で手堅い",
  "price": 1,
  "tickets": [
    {
      "mode": "formation",
      "type": "2f",
      "numbers": [
        {
          "numberset": "12"
        }
      ]
    },
    {
      "mode": "box",
      "type": "2t",
      "numbers": [
        {
          "numberset": "123"
        }
      ]
    },
    {
      "type": "3f",
      "numbers": [
        {
          "numberset": "123"
        }
      ]
    },
    {
      "mode": "formation",
      "numbers": [
        {
          "numberset": "123"
        },
        {
          "numberset": "124"
        },
        {
          "numberset": "125"
        },
        {
          "numberset": "126"
        },
        {
          "numberset": "213",
          "bet": 10000
        },
        {
          "numberset": "214"
        },
        {
          "numberset": "215"
        },
        {
          "numberset": "216"
        }
      ]
    }
  ]
}
curl -X POST "https://v2.mizuhanome.net/api/v1/forecasts/201810130601?session=$session"
  -H "Content-Type: application/json"
  -d '{"headline":"テスト予想","note":"1はモーターを交換した\n2はA1で手堅い","price":1,"tickets":[{"mode":"formation","type":"2f","numbers":[{"numberset":"12"}]},{"mode":"box","type":"2t","numbers":[{"numberset":"123"}]},{"type":"3f","numbers":[{"numberset":"123"}]},{"mode":"formation","numbers":[{"numberset":"123"},{"numberset":"124"},{"numberset":"125"},{"numberset":"126"},{"numberset":"213","bet":10000},{"numberset":"214"},{"numberset":"215"},{"numberset":"216"}]}]}'

投稿成功時、以下のようなJSONが帰ります:

{
  "status": "success",
  "url": "/forecasts/32",
  "data": {
    "id": 32,
    "dataid": 201810130601,
    "headline": "テスト予想",
    "note": "1はモーターを交換した\n2はA1で手堅い",
    "bet": 11000,
    "price": 1,
    "tickets": [
      {
        "type": "2f",
        "mode": "formation",
        "numbersets": "1-2",
        "bet": 100,
        "numbers": [
          {
            "numberset": "12",
            "bet": 100
          }
        ]
      },
      {
        "type": "2t",
        "mode": "box",
        "numbersets": "12",
        "bet": 100,
        "numbers": [
          {
            "numberset": "12",
            "bet": 100
          }
        ]
      },
      {
        "type": "3f",
        "mode": "single",
        "numbersets": "1-2-3",
        "bet": 100,
        "numbers": [
          {
            "numberset": "123",
            "bet": 100
          }
        ]
      },
      {
        "type": "3t",
        "mode": "formation",
        "numbersets": "12-12-3456",
        "bet": 10700,
        "numbers": [
          {
            "numberset": "123",
            "bet": 100
          },
          {
            "numberset": "124",
            "bet": 100
          },
          {
            "numberset": "125",
            "bet": 100
          },
          {
            "numberset": "126",
            "bet": 100
          },
          {
            "numberset": "213",
            "bet": 10000
          },
          {
            "numberset": "214",
            "bet": 100
          },
          {
            "numberset": "215",
            "bet": 100
          },
          {
            "numberset": "216",
            "bet": 100
          }
        ]
      }
    ]
  }
}

指定したdataidのレースに対して予想を投稿します

HTTP Request

POST https://v2.mizuhanome.net/api/v1/forecasts/:dataid

送信するJSONの書式

Key Default Type Description
headline null String 予想の見出しです。常に公開されます。100文字まで入力できます
note '' String 予想に対する考察です。販売時には非公開になります。65535文字まで入力できます
price 0 Number 予想の販売価格(ポイント)です。0の場合は即座に公開します。
tickets required Array 1以上の券情報です
tickets[].type 3t 3t,3f,2t,2f 券種を指定します
tickets[].mode single single,box,formation 券の買い方を指定します(省略時は「通常」と表示されます)
tickets[].numbers required Array 1以上の組番情報です
tickets[].numbers[].numberset required String(3) 組番を指定します
tickets[].numbers[].bet 100 Number 組番に対する賭け金(円)です
unlimited null Boolean 月額会員がポイントなしで閲覧できる【UL限定】に設定します。閲覧されたものは毎月【UL売り上げ】として売り上げ管理から振込申請することが可能です(銀行振り込み手数料を引いて、残高5,000円以上からとなります)
autobuy null Boolean trueを設定すると、同時に舟券購入も行います。月額会員である必要があります
private false Boolean trueに設定すると、自分以外に閲覧不可能になります。「マイページ>自分の予想」でのみ表示されます

返ってくるJSONのキーの意味

Key Type Description
id Number 予想データのidです、予想ページのurlに使用します
dataid Number レースidです、レースページのurlに使用します
bet Number 予想の総賭け金です
tickets[].bet Number 券の合計賭け金です
tickets[].numbersets Number 券の組番の概略です
autobuy Object autobuytrueに設定したときだけ、舟券購入の結果が返ります

舟券購入

舟券購入だけを行うことも可能です

キュー送信

{
  "tickets": [
    {
      "numbers": [
        {
          "numberset": "123"
        }
      ]
    }
  ]
}

上記のようなPOSTデータが最小の投稿情報です、以下のように送信します:

curl -X POST "https://v2.mizuhanome.net/api/v1/autobuy/201810130601?session=$session"
  -H "Content-Type: application/json"
  -d '{"tickets":[{"numbers":[{"numberset":"123"}]}]}'

投稿成功時、以下のようなJSONが帰ります:

{
  "status": 2,
  "message": "ご投票ありがとうございました。以下の内容で投票が完了しました。\n契約番号 : 0025\n成立ベット/申込ベット  1/1\n購入成立金額  100円\n...",
  "dataid": 201810130601,
  "queues": [
    [
      {
        "ticketType": "3t",
        "ticketNum": "123",
        "price": 100
      }
    ]
  ]
}

送信した組番が12点以内の場合、キューは即時実行され、返されるJSONにはmessageを含みます。13点以上の場合、キーは保留になり、messageを含みません。

HTTP Request

POST https://v2.mizuhanome.net/api/v1/autobuy/:dataid

送信するJSONの書式

Key Default Type Description
tickets required Array 1以上の券情報です
tickets[].type 3t 3t,3f,2t,2f 券種を指定します
tickets[].numbers required Array 1以上の組番情報です
tickets[].numbers[].numberset required String(3) 組番を指定します
tickets[].numbers[].bet 100 Number 組番に対する賭け金(円)です

返ってくるJSONのキーの意味

Key Type Description
status Number -1:失敗,0:待機,1:処理中,2:完了 キューの状況です、即時実行されなかった場合は0が返ります。
message String 即時実行時、Web投票公式のメッセージの一部が表示されます。即時実行されなかった場合は存在しません
dataid Number 対象のレースid
queues[].ticketType String 券種 3t,3f,2t,2f
queues[].ticketNum String 組番
queues[].price Number 賭け金

データ提供

月額会員のユーザーさま限定で、みずはのめで使用しているデータの提供を行っています。 それぞれのデータは2015年1月1日当日まで

の形式で利用が可能です。

出走表

レース>レース情報>出走表で使用しているデータを返します。

curl "https://v2.mizuhanome.net/api/v1/data/racecard/201501010601?session=$session"
# or ...
curl "https://v2.mizuhanome.net/api/v1/data/racecard/2015/01?session=$session"

HTTP Request

直前情報

レース>レース情報>直前情報で使用しているデータを返します。

curl "https://v2.mizuhanome.net/api/v1/data/beforeinfo/201501010601?session=$session"
# or ...
curl "https://v2.mizuhanome.net/api/v1/data/beforeinfo/2015/01?session=$session"

HTTP Request

オッズ

レース>オッズで使用しているデータを返します。

curl "https://v2.mizuhanome.net/api/v1/data/odds/201703080501?session=$session"
# or ...
curl "https://v2.mizuhanome.net/api/v1/data/odds/2017/03?session=$session"

HTTP Request

コンピューター予想

公式のコンピューター予想のデータを返します。

curl "https://v2.mizuhanome.net/api/v1/data/computer_forecast/201703090201?session=$session"
# or ...
curl "https://v2.mizuhanome.net/api/v1/data/computer_forecast/2017/03?session=$session"

HTTP Request

結果

レース>結果で使用しているデータを返します。

curl "https://v2.mizuhanome.net/api/v1/data/raceresult/201501010601?session=$session"
# or ...
curl "https://v2.mizuhanome.net/api/v1/data/raceresult/2015/01?session=$session"

HTTP Request

返されるデータの詳細

出走表

curl "https://v2.mizuhanome.net/api/v1/data/racecard/201501010601?session=$session"
# {
#   "body": {
#     "dataid": 201501010601,
#     "hd": "2015-01-01",
#     "jcd": 6,
#     "rno": 1,
#     "nj": "2日目",
#     "kfrom": "2014-12-31",
#     "kto": "2015-01-06",
#     "jname": "浜名湖",
#     "tbgradename": null,
#     "ktitle": "静岡新聞社・静岡放送 New Year’s Cup",
#     "nightflag": 0,
#     "gradeicon": "is-regular",
#     "rtitle": "予 選",
#     "koteiflag": 0,
#     "distance": 1800,
#     "anteibanflag": 2,
#     "deadline": "10:41:00",
#     "deadlinegai": "10:41:00",
#     "deadlinechangekbn": "0",
#     "player1_racerno": "4033",
#     "player1_racername": "伊藤  将吉",
#     "player1_absentflag": 0,
#     "player1_shibu": "静岡",
#     "player1_birthplace": "静岡",
#     "player1_age": "36",
#     "player1_weight": "50.1",
#     "player1_classname": "A1",
#     "player1_ftimes": "F0",
#     "player1_ltimes": "L0",
#     "player1_zwinper": "6.32",
#     "player1_ztop2per": "49.60",
#     "player1_ztop3per": "65.60",
#     "player1_jwinper": "6.24",
#     "player1_jtop2per": "50.80",
#     "player1_jtop3per": "62.90",
#     "player1_motorno": "31",
#     "player1_motor2per": "42.00",
#     "player1_motor3per": "-",
#     "player1_boatno": "31",
#     "player1_boat2per": "35.90",
#     "player1_boat3per": "-",
#     "player1_hayami": "9",
#     "player1_avest": "0.14",
#...
フィールド名 説明
dataid データID。キー。年(4桁)+月(2桁)+日(2桁)+場所(2桁)+R(2桁)。
hd 日付。年(4桁)-月(2桁)-日(2桁)。
jcd 場所番号。1から24
rno R番号。1から12。
nj 節の何日目か
kfrom 節の開始日
kto 節の予定終了日
jname 場所の名前
tbgradename その大会のグレード。G1やG2など。2017年1月ごろから利用可能です
ktitle 大会名
nightflag ナイターレースフラグ
gradeicon レースグレード
rtitle レースタイトル
koteiflag 侵入固定フラグ
distance レース距離
anteibanflag 安定板フラグ
deadline 締切時刻
deadlinegai 場外締切時刻
deadlinechangekbn 締切時刻変更区分
player1_racerno レーサー番号
player1_racername レーサー名前
player1_absentflag 出走するかどうかのフラグ。1なら出走しない。例→201812141408
player1_shibu 支部
player1_birthplace 出身
player1_age 年齢
player1_weight 体重
player1_classname クラス
player1_ftimes フライング回数
player1_ltimes 出遅れ回数
player1_zwinper 全国勝率
player1_ztop2per 全国2連率
player1_ztop3per 全国3連率
player1_jwinper 当地勝率
player1_jtop2per 当地2連率
player1_jtop3per 当地3連率
player1_motorno モーター番号
player1_motor2per モーター2連率
player1_motor3per モーター3連率
player1_boatno ボート番号
player1_boat2per ボート2連率
player1_boat3per ボート3連率
player1_hayami 早見
player1_avest 平均スタートタイミング
player2_* 同上
player3_* 同上
player4_* 同上
player5_* 同上
player6_* 同上

直前情報

curl "https://v2.mizuhanome.net/api/v1/data/beforeinfo/201501010601?session=$session"
# {
#   "status": "200",
#   "body": {
#     "dataid": 201501010601,
#     "player1_adjweight": "0.0",
#     "player1_tilt": "-0.5",
#     "player1_extime": "6.79",
#     "player1_chpartinfolist": "[]",
#     "player1_lastresult_rno": 0,
#     "player1_lastresult_teino": 0,
#     "player1_lastresult_cs": null,
#     "player1_lastresult_st": null,
#     "player1_lastresult_chk": null,
#     "player1_sttenjiinfolist_cs": 1,
#     "player1_sttenjiinfolist_st": "F.02",
# ...    
#     "measuretime": "10:00現在",
#     "weather": "晴",
#     "wave": "3cm",
#     "wind": "4m",
#     "temp": "5.0℃",
#     "water": "8.0℃",
#     "winddirec": "03"
#   }
# }
name description
dataid データID。キー。年(4桁)+月(2桁)+日(2桁)+場所(2桁)+R(2桁)。
player1_adjweight 調整重量。体重が最低体重以下だと、ハンデとしておもりを持つ。その重量。
player1_tilt チルト角度
player1_extime 展示タイム
player1_chpartinfolist パーツ交換の有無。[]だとパーツ交換なし。それ以外だとパーツ交換あり。(内容は不明
player1_lastresult_rno 当日前レースのR番号。0は当日の前レースなし。
player1_lastresult_teino 当日前レースの艇番号。0は当日の前レースなし。
player1_lastresult_cs 当日前レースの枠番号。NAは当日の前レースなし。
player1_lastresult_st 当日前レースのスタートタイミング。NAは当日の前レースなし。
player1_lastresult_chk 当日前レースの着順。NAは当日の前レースなし。
player1_sttenjiinfolist_cs スタート展示の枠番号
player1_sttenjiinfolist_st スタート展示のスタートタイミング
player2_* 同上
player3_* 同上
player4_* 同上
player5_* 同上
player6_* 同上
measuretime いつ時点のデータか
weather 天気
wave 波の高さ
wind 風速
temp 気温
water 水温
winddirec 風向。00~16まで17パターン

オッズ

curl "https://v2.mizuhanome.net/api/v1/data/odds/201703080501?session=$session"
# {
#   "status": "200",
#   "body": {
#     "dataid": 201703080501,
#     "updatetime": "21:34:00",
#     "finalodds": 1,
#     "odds_3t123": "18.1",
#     "odds_3t124": "14.3",
#     "odds_3t125": "88.1",
#     "odds_3t126": "14.1",
#     "odds_3t132": "23.1",
#     "odds_3t134": "18.0",
#     "odds_3t135": "101.9",
#     "odds_3t136": "17.2",
#     ...
#   }
# }
name description
dataid データID。キー。年(4桁)+月(2桁)+日(2桁)+場所(2桁)+R(2桁)。
updatetime 更新時間。
finalodds ファイナルオッズフラグ。
odds_3t123 それぞれのオッズが入ります(後略)

コンピューター予想

curl "https://v2.mizuhanome.net/api/v1/data/computer_forecast/201703090201?session=$session"
# {
#   "status": "200",
#   "body": {
#     "dataid": 201703090201,
#     "player1_mark": "○",
#     "player2_mark": "◎",
#     "player3_mark": "△",
#     "player4_mark": null,
#     "player5_mark": "×",
#     "player6_mark": null,
#     "jisin": "★★",
#     "courslist1": "1",
#     "courslist2": "2",
#     "courslist3": "3",
#     "courslist4": "4",
#     "courslist5": "5",
#     "courslist6": "6",
#     "focus3rtlist1": "2=1-3",
#     "focus3rtlist2": "2=3-1",
#     "focus3rtlist3": "2=1-5",
#     "focus3rtlist4": "2=3-5",
#     "focus3rtlist5": "2-5-1",
#     "focus3rtlist6": "2-5-3",
#     "focus2rtlist1": "2=1",
#     "focus2rtlist2": "2=3",
#     "focus2rtlist3": "2-5",
#     "focus2rtlist4": "1-3"
#   }
# }
name description
dataid データID。キー。年(4桁)+月(2桁)+日(2桁)+場所(2桁)+R(2桁)。
player1_mark ◎や○等のマーク
jisin 「★★★」のような自信度数
courslist1 進入予想
courslist2
courslist3
courslist4
courslist5
courslist6
focus3rtlist1 3連の予想。例: 1=2-3
focus3rtlist2
focus3rtlist3
focus3rtlist4
focus3rtlist5
focus3rtlist6
focus2rtlist1 2連の予想。例: 1=2
focus2rtlist2
focus2rtlist3
focus2rtlist4

結果

curl "https://v2.mizuhanome.net/api/v1/data/raceresult/201501010601?session=$session"
# {
#   "status": "200",
#   "body": {
#     "dataid": 201501010601,
#     "player1_chk": "1",
#     "player1_racetime": "1'49\"7",
#     "player1_cs": 1,
#     "player1_wintech": "逃げ",
#     ...
#     "northdirec": "13",
#     "weather": "晴",
#     "wave": "2cm",
#     "winddirec": "01",
#     "wind": "01",
#     "temp": "6.0℃",
#     "water": "8.0℃",
#     "returnlist": "[]",
#     "remarklist": "[]",
#     "odds_3t123": null,
#     "odds_3t124": null,
#     "odds_3t125": null,
#     "odds_3t126": null,
#     "odds_3t132": null,
#     "odds_3t134": null,
#     "odds_3t135": null,
#     "odds_3t136": null,
#     "odds_3t142": "1770",
#     ...
#     "pop_3t123": null,
#     "pop_3t124": null,
#     "pop_3t125": null,
#     "pop_3t126": null,
#     "pop_3t132": null,
#     "pop_3t134": null,
#     "pop_3t135": null,
#     "pop_3t136": null,
#     "pop_3t142": "7",
#     ...
#   }
# }
name description
dataid データID。キー。年(4桁)+月(2桁)+日(2桁)+場所(2桁)+R(2桁)。
player1_chk 着順
player1_racetime タイム
player1_cs 枠番号
player1_wintech 決まりて
player2_* 同上
player3_* 同上
player4_* 同上
player5_* 同上
player6_* 同上
northdirec 北の方向、01~16の16パターン
weather 天気
wave 波の高さ
winddirec 風向。00~16まで17パターン。
wind 風速
temp 気温
water 水温
returnlist 返還艇リスト
remarklist [], [同着あり], [返還艇あり]の3パターン
odds_3t123 それぞれのオッズが入ります(後略)
pop_3t123 それぞれの人気が入ります(後略)