今日バド Developer Platform

KYOBAD DEVELOPER PLATFORM

練習情報を、
あなたの仕組みから今日バドへ。

サークルの管理ツールやフォームから、公開する練習予定を直接登録できます。登録した予定の主催者は、APIキーを発行したLINEアカウントになります。

APIキーを発行 5分で試す
POST /api/v1/practices
Authorization: Bearer kyb_live_••••••••
Idempotency-Key: practice-20260912-01

{
  "organizerName": "シャトルクラブ",
  "date": "2026-09-12",
  "venue": "〇〇市民体育館",
  "startTime": "18:00"
}
201 Created練習予定を公開しました

API KEYS

APIキー

キーはアカウントごとに管理され、作成した練習はそのユーザーの開催予定として扱われます。

ログイン状態を確認しています

少しだけお待ちください。

QUICKSTART

5分で登録する

APIキーをコードへ直接書き込まず、サーバーの環境変数で管理してください。

1

LINEでログイン

練習の主催者になる今日バドのアカウントでログインします。

2

APIキーを発行

表示されるキーを安全な場所へ保存します。再表示はできません。

3

POSTで登録

JSONを送ると、検証後すぐ今日バドの開催予定へ反映されます。

API REFERENCE

APIドキュメント

現在のAPIは練習予定の新規登録に対応しています。

認証

すべてのAPIリクエストに、発行したキーをBearerトークンとして指定します。APIキーはブラウザや配布アプリへ埋め込まず、サーバーから送信してください。

Authorization: Bearer kyb_live_YOUR_API_KEY
POSThttps://xn--gdkn531u9pu.com/api/v1/practices

APIキーを発行したユーザーの開催予定として、練習を1件作成して公開します。プロフィールに登録したヘッダー画像も通常の作成画面と同様に引き継がれます。

重複登録を防ぐ

同じ登録を再試行する可能性がある場合は、リクエストごとに固有の Idempotency-Key を指定してください。同じキーと内容なら、2回目以降は新しい予定を作らず既存結果を返します。

curl -X POST 'https://xn--gdkn531u9pu.com/api/v1/practices' \
  -H 'Authorization: Bearer kyb_live_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: practice-20260912-01' \
  -d '{
    "organizerType": "group",
    "organizerName": "シャトルクラブ",
    "prefecture": "東京都",
    "municipality": "新宿区",
    "venue": "〇〇市民体育館",
    "access": "〇〇駅から徒歩8分",
    "contentType": "games",
    "content": "基礎打ちのあと、ダブルスのゲーム練習を行います。",
    "overview": "初参加の方も歓迎です。",
    "playType": "doubles",
    "fee": 800,
    "level": "intermediate",
    "conditions": "高校生以上",
    "flow": "受付後、各自で準備運動をお願いします。",
    "date": "2026-09-12",
    "startTime": "18:00",
    "endTime": "21:00",
    "repeat": "none",
    "capacity": 20,
    "approvalRequired": true
  }'

入力項目

項目必須型・制限内容
organizerType必須personal / group個人または団体
organizerName必須文字列・100文字以内主催者名
prefecture必須文字列・16文字以内都道府県
municipality任意文字列・100文字以内市区町村
venue必須文字列・255文字以内会場名
access任意文字列・255文字以内交通・アクセス
contentType必須rally / games / lesson / mixed練習内容の種類
content必須文字列・3,000文字以内練習内容
overview任意文字列・3,000文字以内紹介・補足
playType必須singles / doubles / both種目
fee任意整数・0〜1,000,000参加費。省略時は0
level必須beginner / intermediate / advanced対象レベル
conditions任意文字列・3,000文字以内参加条件
flow任意文字列・3,000文字以内当日の流れ
date必須YYYY-MM-DD最初の開催日
startTime必須HH:mm開始時刻
endTime必須HH:mm終了時刻。開始時刻より後
repeat任意none / weekly / biweekly / monthly繰り返し。省略時はnone
repeatUntil任意YYYY-MM-DD繰り返し終了日
excludedDates任意日付文字列の配列繰り返しから除外する日
capacity任意整数・1〜999定員。省略時は1
approvalRequired任意真偽値参加を承認制にするか

成功レスポンス

新規作成時は 201 Created、同じIdempotency-Keyの再送時は 200 OK と Idempotent-Replayed: true を返します。

{
  "practice": {
    "id": 123,
    "ownerUserId": 45,
    "organizerType": "group",
    "organizerName": "シャトルクラブ",
    "date": "2026-09-12",
    "startTime": "18:00",
    "endTime": "21:00"
  }
}

利用上限：APIキーごとに1時間120件、送信元IPごとに1時間300件です。

エラー

400JSONやIdempotency-Keyが不正
401APIキーがない、無効、または権限不足
409Idempotency-Keyの内容が競合
413リクエスト本文が64KBを超過
422開催情報の入力エラー
429利用上限を超過
500サーバー内部エラー
{
  "error": {
    "code": "invalid_practice",
    "message": "開催情報を確認してください。"
  }
}

安全な使い方

  • APIキーはパスワードと同じように扱い、Gitや公開ページへ保存しないでください。
  • ブラウザ上のJavaScriptや配布するスマホアプリには埋め込まず、自分のサーバーから呼び出してください。
  • 漏えいが疑われる場合は、この画面ですぐ無効化して新しいキーを発行してください。
  • 本番用・検証用など用途ごとにキーを分け、使わなくなったキーは無効化してください。
✓

APIキーを発行しました

このキーを表示できるのは今だけです。コピーして、パスワード管理ツールやサーバーの環境変数へ保存してください。

画面を閉じると、キー全体を再表示することはできません。