{
 "openapi": "3.0.3",
 "info": {
  "title": "Bizarre Bazaar wholesale price (Tianjin) — API",
  "version": "1.0",
  "description": "凭买家密钥访问价目表与下单（bizarrebazaar.cn，我的账户 → API）。价格和标记由服务器按最新价目表计算；下单请求里只放商品编号和数量。"
 },
 "servers": [
  {
   "url": "https://bizarrebazaar.cn"
  }
 ],
 "components": {
  "securitySchemes": {
   "key": {
    "type": "http",
    "scheme": "bearer"
   }
  }
 },
 "security": [
  {
   "key": []
  }
 ],
 "paths": {
  "/api/v1/catalog": {
   "get": {
    "summary": "价目表商品（含价格与标记）",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "tab",
      "in": "query",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "mark",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "pre",
        "promo",
        "clr",
        "new"
       ]
      }
     },
     {
      "name": "limit",
      "in": "query",
      "schema": {
       "type": "integer",
       "default": 200
      }
     },
     {
      "name": "offset",
      "in": "query",
      "schema": {
       "type": "integer",
       "default": 0
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     },
     "403": {
      "description": "密钥没有「价目表」权限"
     }
    }
   }
  },
  "/api/v1/me": {
   "get": {
    "summary": "买家资料",
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/v1/orders": {
   "get": {
    "summary": "我的订单",
    "parameters": [
     {
      "name": "limit",
      "in": "query",
      "schema": {
       "type": "integer",
       "default": 20
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   },
   "post": {
    "summary": "创建订单",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "required": [
         "items"
        ],
        "properties": {
         "lang": {
          "type": "string",
          "enum": [
           "zh",
           "en",
           "ru"
          ]
         },
         "comment": {
          "type": "string"
         },
         "items": {
          "type": "array",
          "items": {
           "type": "object",
           "required": [
            "k",
            "q"
           ],
           "properties": {
            "k": {
             "type": "string"
            },
            "q": {
             "type": "integer",
             "minimum": 1,
             "maximum": 999
            }
           }
          }
         }
        }
       }
      }
     }
    },
    "responses": {
     "201": {
      "description": "订单已创建"
     },
     "400": {
      "description": "空订单或存在未知商品"
     }
    }
   }
  },
  "/api/v1/orders/{no}": {
   "get": {
    "summary": "按订单号查询",
    "parameters": [
     {
      "name": "no",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     },
     "404": {
      "description": "未找到"
     }
    }
   }
  },
  "/api/v1/orders/{no}.pdf": {
   "get": {
    "summary": "订单 PDF",
    "parameters": [
     {
      "name": "no",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "PDF"
     }
    }
   }
  }
 }
}