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
          }
        ]
      }
    ]
  }
}

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

{
  "note": "色々詰め込み過ぎた\n今は反省している",
  "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 '{"note":"色々詰め込み過ぎた\n今は反省している","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,
    "note": "色々詰め込み過ぎた\n今は反省している",
    "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
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 組番に対する賭け金(円)です

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

Key Type Description
id Number 予想データのidです、予想ページのurlに使用します
dataid Number レースidです、レースページのurlに使用します
bet Number 予想の総賭け金です
tickets[].bet Number 券の合計賭け金です
tickets[].numbersets Number 券の組番の概略です