{
  "openapi": "3.1.0",
  "info": {
    "title": "中国匹克球指南 Open Data API",
    "version": "2026-11-05",
    "summary": "中国匹克球指南 (中国大陆, CNY) Read-Only Static Open Data API.",
    "contact": {
      "name": "中国匹克球指南",
      "url": "https://pickleball.fashion/cn/feedback/"
    },
    "license": {
      "name": "Free to cite with attribution to pickleball.fashion",
      "url": "https://pickleball.fashion/cn/copyright/"
    }
  },
  "servers": [
    {
      "url": "https://pickleball.fashion",
      "description": "Production"
    }
  ],
  "paths": {
    "/cn/api/courts-full.json": {
      "get": {
        "operationId": "listCourtsFull_cn",
        "summary": "中国大陆匹克球场馆名录",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/cn/api/courts.json": {
      "get": {
        "operationId": "listCourtsGeo_cn",
        "summary": "Courts Geo Index",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/cn/api/courts.csv": {
      "get": {
        "operationId": "downloadCourtsCsv_cn",
        "summary": "Courts CSV (UTF-8 BOM)",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/cn/api/paddles.json": {
      "get": {
        "operationId": "listPaddles_cn",
        "summary": "匹克球拍规格与价格对比",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/cn/api/apparel.json": {
      "get": {
        "operationId": "listApparel_cn",
        "summary": "匹克球鞋、服装与配件指南",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/cn/api/news.json": {
      "get": {
        "operationId": "listNews_cn",
        "summary": "中国匹克球新闻与赛事动态",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/cn/api/events.json": {
      "get": {
        "operationId": "listEvents_cn",
        "summary": "中国匹克球赛事与活动日历",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/cn/api/learn.json": {
      "get": {
        "operationId": "listLearn_cn",
        "summary": "匹克球规则图解与新手教学",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Paddle": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "const": "CNY"
          },
          "price_min_cny": {
            "type": [
              "integer",
              "null"
            ]
          },
          "price_max_cny": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    }
  }
}