{
  "openapi": "3.1.0",
  "info": {
    "title": "한국 피클볼 가이드 Open Data API",
    "version": "2026-11-05",
    "summary": "한국 피클볼 가이드 (한국, KRW) Read-Only Static Open Data API.",
    "contact": {
      "name": "한국 피클볼 가이드",
      "url": "https://pickleball.fashion/kr/feedback/"
    },
    "license": {
      "name": "Free to cite with attribution to pickleball.fashion",
      "url": "https://pickleball.fashion/kr/copyright/"
    }
  },
  "servers": [
    {
      "url": "https://pickleball.fashion",
      "description": "Production"
    }
  ],
  "paths": {
    "/kr/api/courts-full.json": {
      "get": {
        "operationId": "listCourtsFull_kr",
        "summary": "한국 피클볼 구장 목록 및 지도",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/kr/api/courts.json": {
      "get": {
        "operationId": "listCourtsGeo_kr",
        "summary": "Courts Geo Index",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/kr/api/courts.csv": {
      "get": {
        "operationId": "downloadCourtsCsv_kr",
        "summary": "Courts CSV (UTF-8 BOM)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/kr/api/paddles.json": {
      "get": {
        "operationId": "listPaddles_kr",
        "summary": "피클볼 패들 비교 및 스펙 가이드",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/kr/api/apparel.json": {
      "get": {
        "operationId": "listApparel_kr",
        "summary": "피클볼 코트화·의류·공인구 용품",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/kr/api/news.json": {
      "get": {
        "operationId": "listNews_kr",
        "summary": "한국 피클볼 최신 뉴스",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/kr/api/events.json": {
      "get": {
        "operationId": "listEvents_kr",
        "summary": "피클볼 대회 및 클리닉 일정",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/kr/api/learn.json": {
      "get": {
        "operationId": "listLearn_kr",
        "summary": "피클볼 규칙 및 초보자 입문 가이드",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Paddle": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "const": "KRW"
          },
          "price_min_krw": {
            "type": [
              "integer",
              "null"
            ]
          },
          "price_max_krw": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    }
  }
}