BigTime WebAPI

バージョン 1.0.0

概要

JRDB-APIは、JRDBの競馬データベースにアクセスするためのWeb APIです。レース予測、機械学習、データ分析など様々な用途にご利用いただけます。

ベースURL: https://dev.api.bigtime.world/v1

データ分類

今週データ (t_*)

当週のレース予測用データ。レース前の指数・調教・直前情報など。

過去データ (d_*)

過去のレース結果・分析用データ。機械学習の学習データに最適。

マスタ (m_*)

馬、騎手、調教師の基本情報。IDから詳細を取得する際に使用。

認証

APIキー（必須）

すべてのリクエストにAPIキーが必要です。クエリパラメータとして渡します。アプリケーション固有のキーで、全ユーザー共通です。

GET /tky?api_key=AIzaSyCKRaWx2yZ6LmaYGD8KGTFpG5kd5LnUxDA

認証キー（必須）

ユーザー固有の認証キーです。x-user-key ヘッダーに含めます。ダッシュボードから取得できます。

x-user-key: YOUR_AUTH_KEY

⚠️ 認証キーの取り扱い

認証キーはユーザー固有の秘密情報です。GitHubなどの公開リポジトリにコミットしないでください。環境変数での管理を推奨します。

エンドポイント命名規則

エンドポイントはテーブル名からアンダースコアを除去した形式です。

テーブル名	エンドポイント	説明
`t_ky`	`/tky`	競走馬データ（今週）
`d_se`	`/dse`	成績データ（過去）
`m_uk`	`/muk`	競走馬マスタ

クイックスタート

# YOUR_API_KEY: アプリケーション共通のAPIキー
# YOUR_AUTH_KEY: ユーザー固有の認証キー（ダッシュボードで確認）

curl -X POST "https://dev.api.bigtime.world/v1/tra?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-user-key: YOUR_AUTH_KEY" \
  -d '{"racedate": "20251129"}'

YOUR_API_KEY（APIキー）とYOUR_AUTH_KEY（認証キー）はダッシュボードから取得できます。