{
  "openapi": "3.0.0",
  "info": {
    "title": "亚马逊按类别获取商品 API (V1)",
    "version": "1.0.0",
    "description": "获取亚马逊按类别商品数据，包括标题、价格和评分，用于基于类别的商品发现，并返回商品信息，如标题、价格和评分。"
  },
  "paths": {
    "/api/amazon/get-category-products/v1": {
      "get": {
        "tags": [
          "亚马逊"
        ],
        "summary": "按类别获取商品",
        "description": "获取亚马逊按类别商品数据，包括标题、价格和评分，用于基于类别的商品发现，并返回商品信息，如标题、价格和评分。",
        "operationId": "getProductsByCategoryV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "此API服务的鉴权令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "categoryId",
            "in": "query",
            "description": "例如：https://amazon.com/s?node=172282 - 亚马逊类别 ID 为 172282",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "亚马逊产品的国家代码。\n\n可用值：\n- `US`: 美国\n- `AU`: 澳大利亚\n- `BR`: 巴西\n- `CA`: 加拿大\n- `CN`: 中国\n- `FR`: 法国\n- `DE`: 德国\n- `IN`: 印度\n- `IT`: 意大利\n- `MX`: 墨西哥\n- `NL`: 荷兰\n- `SG`: 新加坡\n- `ES`: 西班牙\n- `TR`: 土耳其\n- `AE`: 阿拉伯联合酋长国\n- `GB`: 英国\n- `JP`: 日本\n- `SA`: 沙特阿拉伯\n- `PL`: 波兰\n- `SE`: 瑞典\n- `BE`: 比利时\n- `EG`: 埃及\n- `ZA`: 南非\n- `IE`: 爱尔兰",
            "required": false,
            "schema": {
              "type": "string",
              "default": "US",
              "description": "Amazon Country",
              "enum": [
                "US",
                "AU",
                "BR",
                "CA",
                "CN",
                "FR",
                "DE",
                "IN",
                "IT",
                "MX",
                "NL",
                "SG",
                "ES",
                "TR",
                "AE",
                "GB",
                "JP",
                "SA",
                "PL",
                "SE",
                "BE",
                "EG",
                "ZA",
                "IE"
              ]
            }
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "排序方式。\n\n可用值：\n- `RELEVANCE`: 相关性\n- `LOWEST_PRICE`: 最低价格\n- `HIGHEST_PRICE`: 最高价格\n- `REVIEWS`: 评论\n- `NEWEST`: 最新\n- `BEST_SELLERS`: 畅销品",
            "required": false,
            "schema": {
              "type": "string",
              "default": "RELEVANCE",
              "description": "Amazon Sort By",
              "enum": [
                "RELEVANCE",
                "LOWEST_PRICE",
                "HIGHEST_PRICE",
                "REVIEWS",
                "NEWEST",
                "BEST_SELLERS"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "用于分页的页码。",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          }
        ],
        "responses": {
          "default": {
            "description": "默认响应",
            "content": {
              "application/json": {}
            }
          }
        },
        "x-order": "29001300"
      }
    }
  },
  "components": {}
}