{"openapi":"3.1.0","info":{"title":"シャフトコーチ ゴルフシャフト API","version":"1.0.0","description":"5,300本超・66メーカーのゴルフシャフトスペックを無料で取得できるAPIです。認証不要・CC BY 4.0。","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"シャフトコーチ","url":"https://golf.peaky.co.jp/about"}},"servers":[{"url":"https://golf.peaky.co.jp","description":"本番"}],"paths":{"/data/shafts.json":{"get":{"operationId":"getAllShafts","summary":"全シャフトスペックを一括取得したいときに使います","description":"全シャフトのスペック一覧をJSON形式で返します。サイズが大きいため、メーカー別エンドポイントの利用を推奨します。","responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"shafts":{"type":"array","items":{"$ref":"#/components/schemas/Shaft"}}}}}}}}}},"/data/shafts/{makerSlug}":{"get":{"operationId":"getShaftsByMaker","summary":"特定メーカーのシャフトだけ取得したいときに使います","parameters":[{"name":"makerSlug","in":"path","required":true,"schema":{"type":"string"},"description":"メーカーのスラッグ（例: fujikura, graphite-design）"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","properties":{"maker":{"type":"string"},"count":{"type":"integer"},"shafts":{"type":"array","items":{"$ref":"#/components/schemas/Shaft"}}}}}}}}}},"/api/shafts/search":{"get":{"operationId":"searchShafts","summary":"シャフト名やメーカー名で検索したいときに使います","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"検索クエリ"},{"name":"category","in":"query","schema":{"type":"string","enum":["driver","fairway","utility","iron","wedge","putter","all"]},"description":"カテゴリ。デフォルト: driver"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}}}}}}}},"/api/shafts/similar":{"get":{"operationId":"findSimilar","summary":"指定シャフトに似た現行モデルを探したいときに使います","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"integer"},"description":"シャフトID"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/shafts/recommend":{"get":{"operationId":"recommendForGolfer","summary":"ゴルファーの条件から最適な現行シャフトを提案したいときに使います","parameters":[{"name":"category","in":"query","schema":{"type":"string"},"description":"カテゴリ"},{"name":"weightMin","in":"query","schema":{"type":"number"},"description":"重量下限（g）"},{"name":"weightMax","in":"query","schema":{"type":"number"},"description":"重量上限（g）"},{"name":"kickPoint","in":"query","schema":{"type":"string"},"description":"調子"},{"name":"flex","in":"query","schema":{"type":"string"},"description":"フレックス"}],"responses":{"200":{"description":"成功（現行品のみ、スコア順に最大5件）","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}}}}}}}}},"components":{"schemas":{"Shaft":{"type":"object","properties":{"name":{"type":"string"},"maker":{"type":"string"},"weight":{"type":"number","description":"重量（g）"},"flex":{"type":"string"},"torque":{"type":["number","null"],"description":"トルク（度）。約7%のモデルは null"},"kickPoint":{"type":"string","description":"調子（先調子/先中調子/中調子/中元調子/元調子）"},"launch":{"type":"string","description":"弾道（高弾道〜低弾道）"},"category":{"type":"string"},"discontinued":{"type":"boolean","description":"廃盤フラグ"},"url":{"type":"string","format":"uri","description":"詳細ページURL"}}},"SearchResult":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"maker":{"type":"string"},"weight":{"type":"number"},"flex":{"type":"string"},"torque":{"type":["number","null"]},"kickPoint":{"type":"string"},"category":{"type":"string"},"isDiscontinued":{"type":"boolean"},"description":{"type":["string","null"]},"imageUrl":{"type":["string","null"]}}}}}}