{
  "openapi": "3.1.0",
  "info": {
    "title": "云灵客户业务适配协议",
    "version": "2.1.0",
    "description": "由 woodenhorse Go 后端调用，浏览器不直接调用。所有示例为契约示例；实际业务信息由客户服务器提供。参阅 customer-api.md。"
  },
  "servers": [
    {
      "url": "https://api.customer.example/woodenhorse",
      "description": "替换为客户公网 HTTPS 基础地址"
    }
  ],
  "security": [
    {
      "CustomerBearer": []
    }
  ],
  "paths": {
    "/v1/products/search": {
      "post": {
        "operationId": "searchProducts",
        "summary": "查询适用商品",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "name": "X-User-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "description": "客户稳定用户 ID，按 application/x-www-form-urlencoded 编码，接收方解码一次"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Trip"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Products"
                }
              }
            }
          },
          "401": {
            "description": "服务凭证不正确",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "授权不足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "记录不存在或无权访问",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态冲突或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "不能受理当前信息",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/checkout": {
      "post": {
        "operationId": "createCheckout",
        "summary": "创建预订确认入口，不扣款",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          },
          {
            "$ref": "#/components/parameters/Idempotency-Key"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckoutRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Checkout"
                }
              }
            }
          },
          "201": {
            "description": "受理成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Checkout"
                }
              }
            }
          },
          "401": {
            "description": "服务凭证不正确",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "授权不足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "记录不存在或无权访问",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态冲突或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "不能受理当前信息",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/orders/search": {
      "post": {
        "operationId": "searchOrders",
        "summary": "查询当前用户可售后订单",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderSearch"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Orders"
                }
              }
            }
          },
          "401": {
            "description": "服务凭证不正确",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "授权不足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "记录不存在或无权访问",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态冲突或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "不能受理当前信息",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/complaints": {
      "post": {
        "operationId": "createComplaint",
        "summary": "登记投诉售后",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          },
          {
            "$ref": "#/components/parameters/Idempotency-Key"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ComplaintRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "201": {
            "description": "受理成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "401": {
            "description": "服务凭证不正确",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "授权不足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "记录不存在或无权访问",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态冲突或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "不能受理当前信息",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/complaints/lookup": {
      "post": {
        "operationId": "getComplaint",
        "summary": "查询本人投诉进度",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Reference"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "401": {
            "description": "服务凭证不正确",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "授权不足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "记录不存在或无权访问",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态冲突或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "不能受理当前信息",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/lost-items": {
      "post": {
        "operationId": "registerLostItem",
        "summary": "登记遗失物品",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          },
          {
            "$ref": "#/components/parameters/Idempotency-Key"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LostRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "201": {
            "description": "受理成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "401": {
            "description": "服务凭证不正确",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "授权不足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "记录不存在或无权访问",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态冲突或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "不能受理当前信息",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/lost-items/lookup": {
      "post": {
        "operationId": "getLostItem",
        "summary": "查询本人失物登记",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LostLookup"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "401": {
            "description": "服务凭证不正确",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "授权不足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "记录不存在或无权访问",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态冲突或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "不能受理当前信息",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/lost-items/claim": {
      "post": {
        "operationId": "requestPickup",
        "summary": "申请核验与领取安排，不自动确认交付",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          },
          {
            "$ref": "#/components/parameters/Idempotency-Key"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LostClaim"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "201": {
            "description": "受理成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "401": {
            "description": "服务凭证不正确",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "授权不足",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "记录不存在或无权访问",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态冲突或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "不能受理当前信息",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "请求过于频繁",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "服务异常",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/catalog/options": {
      "post": {
        "operationId": "catalogOptions",
        "summary": "查询可选日期、酒店、房型和雪具",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CatalogQuery"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogOptions"
                }
              }
            }
          },
          "401": {
            "description": "身份或服务凭证无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "当前用户找不到该记录",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "参数无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "限流",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "服务暂不可用",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/resort/status": {
      "post": {
        "operationId": "resortStatus",
        "summary": "雪道与缆车运行信息",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResortStatus"
                }
              }
            }
          },
          "401": {
            "description": "身份或服务凭证无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "当前用户找不到该记录",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "参数无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "限流",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "服务暂不可用",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/merchants/search": {
      "post": {
        "operationId": "searchMerchants",
        "summary": "商家分类与导航",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MerchantQuery"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Merchants"
                }
              }
            }
          },
          "401": {
            "description": "身份或服务凭证无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "当前用户找不到该记录",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "参数无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "限流",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "服务暂不可用",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/support/info": {
      "post": {
        "operationId": "supportInfo",
        "summary": "人工客服与救援联系方式",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportInfo"
                }
              }
            }
          },
          "401": {
            "description": "身份或服务凭证无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "当前用户找不到该记录",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "参数无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "限流",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "服务暂不可用",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/support/sessions": {
      "post": {
        "operationId": "startSupport",
        "summary": "接入人工客服",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          },
          {
            "$ref": "#/components/parameters/Idempotency-Key"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Empty"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportSession"
                }
              }
            }
          },
          "401": {
            "description": "身份或服务凭证无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "当前用户找不到该记录",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "参数无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "限流",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "服务暂不可用",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/support/sessions/lookup": {
      "post": {
        "operationId": "getSupport",
        "summary": "查询人工客服会话",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportQuery"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportSession"
                }
              }
            }
          },
          "401": {
            "description": "身份或服务凭证无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "当前用户找不到该记录",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "参数无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "限流",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "服务暂不可用",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/v1/support/messages": {
      "post": {
        "operationId": "sendSupportMessage",
        "summary": "发送文字或本人订单给人工客服",
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Tenant-ID"
          },
          {
            "$ref": "#/components/parameters/X-Project-ID"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/X-User-ID"
          },
          {
            "$ref": "#/components/parameters/Idempotency-Key"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportSend"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportSession"
                }
              }
            }
          },
          "401": {
            "description": "身份或服务凭证无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "当前用户找不到该记录",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "状态或幂等参数冲突",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "参数无效",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "限流",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "服务暂不可用",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "CustomerBearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "客户分配给 woodenhorse 项目的服务器凭证"
      }
    },
    "parameters": {
      "X-Tenant-ID": {
        "name": "X-Tenant-ID",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "description": "凭证所授权的租户"
      },
      "X-Project-ID": {
        "name": "X-Project-ID",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "description": "凭证所授权的项目"
      },
      "X-Request-ID": {
        "name": "X-Request-ID",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "description": "每次请求的追踪 UUID"
      },
      "X-User-ID": {
        "name": "X-User-ID",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "description": "客户稳定用户 ID，按 application/x-www-form-urlencoded 编码，接收方解码一次"
      },
      "Idempotency-Key": {
        "name": "Idempotency-Key",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9_-]{16,80}$"
        },
        "description": "同用户、项目、操作、请求参数的重试复用此值；必须原子去重"
      }
    },
    "schemas": {
      "Trip": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "minLength": 10,
            "maxLength": 10,
            "format": "date"
          },
          "days": {
            "type": "integer",
            "minimum": 1,
            "maximum": 7
          },
          "adults": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "children": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20
          },
          "budget": {
            "type": "string",
            "minLength": 0,
            "maxLength": 80,
            "description": "H5 选项：不限、500 元以内、500–1,000 元、1,000–2,000 元、2,000 元以上"
          },
          "lodging": {
            "type": "string",
            "minLength": 0,
            "maxLength": 80,
            "description": "需要住宿 / 已有住宿 / 不需要住宿"
          },
          "level": {
            "type": "string",
            "minLength": 0,
            "maxLength": 80,
            "description": "初次滑雪 / 有一定基础 / 熟练滑雪"
          },
          "preference": {
            "type": "string",
            "minLength": 0,
            "maxLength": 80,
            "description": "侧重滑雪 / 亲子轻松 / 餐饮休闲"
          },
          "category": {
            "type": "string",
            "enum": [
              "tickets",
              "stay",
              "offers",
              "camp",
              "lesson",
              "pass"
            ]
          },
          "endDate": {
            "type": "string",
            "format": "date"
          },
          "hotelId": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          },
          "roomId": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          },
          "equipmentId": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          },
          "childrenDetails": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/ChildDetails"
            },
            "description": "可选；提供时数组长度必须等于 children。未提供的年龄或身高不可用于推断购票资格。"
          }
        },
        "required": [
          "date",
          "days",
          "adults",
          "children",
          "budget",
          "lodging",
          "level",
          "preference"
        ],
        "additionalProperties": false
      },
      "Product": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "description": {
            "type": "string",
            "minLength": 0,
            "maxLength": 1000
          },
          "priceCents": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100000000
          },
          "currency": {
            "type": "string",
            "enum": [
              "CNY"
            ]
          },
          "imageURL": {
            "type": "string",
            "minLength": 0,
            "maxLength": 2000,
            "description": "HTTPS 图片地址，可为空"
          },
          "available": {
            "type": "boolean"
          },
          "priceLabel": {
            "type": "string",
            "minLength": 0,
            "maxLength": 120,
            "description": "价格单位，是否为起价及适用人数"
          },
          "sold": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2147483647
          },
          "eligibility": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "adult",
              "child",
              "conditions"
            ],
            "properties": {
              "adult": {
                "type": "string",
                "minLength": 1,
                "maxLength": 300
              },
              "child": {
                "type": "string",
                "minLength": 1,
                "maxLength": 300
              },
              "conditions": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500
              }
            }
          },
          "category": {
            "type": "string",
            "enum": [
              "tickets",
              "stay",
              "offers",
              "camp",
              "lesson",
              "pass"
            ],
            "description": "可选，行程混合推荐时明确商品分类；省略显示通用标题，不按顺序猜测。预订时原样传递已验证分类。"
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "priceCents",
          "currency",
          "imageURL",
          "available",
          "priceLabel"
        ],
        "additionalProperties": false
      },
      "Products": {
        "type": "object",
        "properties": {
          "products": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/Product"
            }
          }
        },
        "required": [
          "products"
        ],
        "additionalProperties": false
      },
      "Order": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "status": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "category": {
            "type": "string",
            "minLength": 0,
            "maxLength": 20
          },
          "amountCents": {
            "type": "integer",
            "minimum": 0
          },
          "quantity": {
            "type": "integer",
            "minimum": 0
          },
          "date": {
            "type": "string",
            "format": "date"
          },
          "imageURL": {
            "anyOf": [
              {
                "type": "string",
                "const": ""
              },
              {
                "type": "string",
                "format": "uri",
                "pattern": "^https://",
                "maxLength": 2000
              }
            ]
          },
          "detailURL": {
            "anyOf": [
              {
                "type": "string",
                "const": ""
              },
              {
                "type": "string",
                "format": "uri",
                "pattern": "^https://",
                "maxLength": 2000
              }
            ]
          },
          "payURL": {
            "anyOf": [
              {
                "type": "string",
                "const": ""
              },
              {
                "type": "string",
                "format": "uri",
                "pattern": "^https://",
                "maxLength": 2000
              }
            ]
          },
          "description": {
            "type": "string",
            "maxLength": 1000
          },
          "admission": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "imageURL",
              "expiresAt"
            ],
            "properties": {
              "imageURL": {
                "type": "string",
                "format": "uri",
                "pattern": "^https://",
                "maxLength": 2000
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time"
              },
              "caption": {
                "type": "string",
                "maxLength": 120
              }
            },
            "description": "仅返回当前 X-User-ID 所属订单的有效入园凭证。客户端在 expiresAt 到期时隐藏；平台不生成二维码。"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "订单创建时间，带时区；用于创建时间查询。"
          },
          "sold": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100000000,
            "description": "商品真实累计销量；不是当前订单数量。"
          },
          "purchaseURL": {
            "type": "string",
            "format": "uri",
            "pattern": "^https://",
            "maxLength": 2000,
            "description": "可选，再次购买该商品的客户确认页；GET 只打开页面，不创建或支付订单。"
          }
        },
        "required": [
          "id",
          "title",
          "status"
        ],
        "additionalProperties": false
      },
      "Orders": {
        "type": "object",
        "properties": {
          "orders": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/Order"
            }
          }
        },
        "required": [
          "orders"
        ],
        "additionalProperties": false
      },
      "CheckoutRequest": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "date": {
            "type": "string",
            "minLength": 10,
            "maxLength": 10,
            "format": "date"
          },
          "adults": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "children": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20
          },
          "category": {
            "type": "string",
            "enum": [
              "tickets",
              "stay",
              "offers",
              "camp",
              "lesson",
              "pass"
            ]
          },
          "endDate": {
            "type": "string",
            "format": "date"
          },
          "hotelId": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          },
          "roomId": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          },
          "equipmentId": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          },
          "childrenDetails": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/ChildDetails"
            },
            "description": "可选；提供时数组长度必须等于 children。未提供的年龄或身高不可用于推断购票资格。"
          }
        },
        "required": [
          "productId",
          "date",
          "adults",
          "children"
        ],
        "additionalProperties": false
      },
      "Checkout": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000,
            "format": "uri",
            "pattern": "^https://"
          },
          "expiresAt": {
            "type": "string",
            "minLength": 20,
            "maxLength": 40,
            "format": "date-time"
          }
        },
        "required": [
          "url",
          "expiresAt"
        ],
        "additionalProperties": false
      },
      "ComplaintRequest": {
        "type": "object",
        "properties": {
          "orderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          }
        },
        "required": [
          "orderId",
          "description"
        ],
        "additionalProperties": false
      },
      "Reference": {
        "type": "object",
        "properties": {
          "reference": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          }
        },
        "required": [
          "reference"
        ],
        "additionalProperties": false
      },
      "LostRequest": {
        "type": "object",
        "properties": {
          "itemName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "lostAt": {
            "type": "string",
            "minLength": 20,
            "maxLength": 35,
            "format": "date-time"
          },
          "location": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "contact": {
            "type": "string",
            "minLength": 3,
            "maxLength": 80
          }
        },
        "required": [
          "itemName",
          "lostAt",
          "location",
          "contact"
        ],
        "additionalProperties": false
      },
      "LostLookup": {
        "type": "object",
        "properties": {
          "reference": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "contact": {
            "type": "string",
            "minLength": 3,
            "maxLength": 80
          }
        },
        "required": [
          "reference",
          "contact"
        ],
        "additionalProperties": false
      },
      "LostClaim": {
        "type": "object",
        "properties": {
          "reference": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "characteristics": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "contact": {
            "type": "string",
            "minLength": 3,
            "maxLength": 80
          }
        },
        "required": [
          "reference",
          "characteristics",
          "contact"
        ],
        "additionalProperties": false
      },
      "Receipt": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "status": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "面向用户的中文状态名称"
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "createdAt": {
            "type": "string",
            "minLength": 20,
            "maxLength": 40,
            "format": "date-time"
          },
          "pickup": {
            "$ref": "#/components/schemas/Pickup"
          }
        },
        "required": [
          "id",
          "status",
          "message",
          "createdAt"
        ],
        "additionalProperties": false
      },
      "Pickup": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "time": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "requirements": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          }
        },
        "required": [
          "location",
          "time",
          "requirements"
        ],
        "additionalProperties": false
      },
      "Empty": {
        "type": "object",
        "properties": {},
        "required": [],
        "additionalProperties": false
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "message": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2000
              },
              "requestId": {
                "type": "string",
                "minLength": 0,
                "maxLength": 100
              }
            },
            "required": [
              "code",
              "message"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "error"
        ],
        "additionalProperties": false
      },
      "OrderSearch": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "all",
              "pending"
            ]
          },
          "createdFrom": {
            "type": "string",
            "format": "date-time",
            "minLength": 20,
            "maxLength": 40,
            "description": "订单创建时间起点（含），RFC 3339 带时区；两个时间字段须同时提供，最长 366 天。"
          },
          "createdBefore": {
            "type": "string",
            "format": "date-time",
            "minLength": 20,
            "maxLength": 40,
            "description": "订单创建时间终点（不含），RFC 3339 带时区；两个时间字段须同时提供，最长 366 天。"
          }
        },
        "required": [],
        "additionalProperties": false,
        "allOf": [
          {
            "if": {
              "anyOf": [
                {
                  "required": [
                    "createdFrom"
                  ]
                },
                {
                  "required": [
                    "createdBefore"
                  ]
                }
              ]
            },
            "then": {
              "required": [
                "createdFrom",
                "createdBefore"
              ]
            }
          }
        ]
      },
      "CatalogQuery": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "enum": [
              "tickets",
              "stay",
              "offers",
              "camp",
              "lesson",
              "pass"
            ]
          },
          "hotelId": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          }
        },
        "required": [
          "category"
        ],
        "additionalProperties": false
      },
      "CatalogChoice": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          }
        },
        "required": [
          "id",
          "label"
        ],
        "additionalProperties": false
      },
      "CatalogOptions": {
        "type": "object",
        "properties": {
          "dates": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "date"
            },
            "maxItems": 366
          },
          "hotels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogChoice"
            },
            "maxItems": 100
          },
          "rooms": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogChoice"
            },
            "maxItems": 100
          },
          "equipment": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogChoice"
            },
            "maxItems": 100
          }
        },
        "required": [
          "dates",
          "hotels",
          "rooms",
          "equipment"
        ],
        "additionalProperties": false
      },
      "ResortStatusItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "kind": {
            "type": "string",
            "enum": [
              "trail",
              "lift"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "open",
              "closed",
              "scheduled",
              "departed"
            ],
            "description": "设施状态；departed（已发车）仅适用于 kind=lift，由客户系统返回，不根据 opensAt 推断。"
          },
          "opensAt": {
            "type": "string",
            "pattern": "^$|^([01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "description": {
            "type": "string",
            "minLength": 0,
            "maxLength": 1000
          },
          "detailURL": {
            "anyOf": [
              {
                "type": "string",
                "const": ""
              },
              {
                "type": "string",
                "format": "uri",
                "pattern": "^https://",
                "maxLength": 2000
              }
            ]
          },
          "operatingHours": {
            "type": "string",
            "maxLength": 80,
            "description": "可选展示时段，例如 08:00–16:30；opensAt 仍为排序开始时间。省略时按 opensAt 显示。"
          },
          "nextDeparture": {
            "type": "object",
            "description": "仅缆车可返回；与 opensAt 开始时间独立，不由前端猜测准时状态。",
            "properties": {
              "time": {
                "type": "string",
                "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
              },
              "state": {
                "type": "string",
                "enum": [
                  "on-time",
                  "scheduled",
                  "delayed",
                  "cancelled"
                ]
              }
            },
            "required": [
              "time",
              "state"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "name",
          "kind",
          "status",
          "opensAt",
          "description",
          "detailURL"
        ],
        "additionalProperties": false
      },
      "ResortStatus": {
        "type": "object",
        "properties": {
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResortStatusItem"
            },
            "maxItems": 200
          },
          "summary": {
            "type": "string",
            "maxLength": 200,
            "description": "客户提供的设施汇总文案，不由当前返回的部分列表推算。"
          },
          "nearestLiftId": {
            "type": "string",
            "maxLength": 100,
            "description": "仅当客户服务持有当前已验证用户授权的有效定位时提供，必须指向 items 中的缆车。没有定位时省略。"
          }
        },
        "required": [
          "updatedAt",
          "items"
        ],
        "additionalProperties": false
      },
      "MerchantQuery": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "enum": [
              "all",
              "food",
              "coffee",
              "snacks",
              "shopping",
              "family"
            ]
          }
        },
        "required": [
          "category"
        ],
        "additionalProperties": false
      },
      "Merchant": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "category": {
            "type": "string",
            "enum": [
              "food",
              "coffee",
              "snacks",
              "shopping",
              "family"
            ]
          },
          "description": {
            "type": "string",
            "minLength": 0,
            "maxLength": 1000
          },
          "imageURL": {
            "anyOf": [
              {
                "type": "string",
                "const": ""
              },
              {
                "type": "string",
                "format": "uri",
                "pattern": "^https://",
                "maxLength": 2000
              }
            ]
          },
          "address": {
            "type": "string",
            "minLength": 0,
            "maxLength": 300
          },
          "navigationURL": {
            "anyOf": [
              {
                "type": "string",
                "const": ""
              },
              {
                "type": "string",
                "format": "uri",
                "pattern": "^https://",
                "maxLength": 2000
              }
            ]
          },
          "distanceMeters": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000,
            "description": "相对当前用户授权有效位置的距离（米），没有位置时省略，不使用 0 代替未知。"
          }
        },
        "required": [
          "id",
          "name",
          "category",
          "description",
          "imageURL",
          "address",
          "navigationURL"
        ],
        "additionalProperties": false
      },
      "Merchants": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Merchant"
            },
            "maxItems": 100
          },
          "nearestId": {
            "type": "string",
            "maxLength": 100,
            "description": "当前响应分类中距离当前用户授权位置最近的商家 ID，必须包含在 items 中；没有位置时省略。"
          }
        },
        "required": [
          "items"
        ],
        "additionalProperties": false
      },
      "SupportInfo": {
        "type": "object",
        "properties": {
          "phone": {
            "type": "string",
            "minLength": 0,
            "maxLength": 26
          },
          "hours": {
            "type": "string",
            "minLength": 0,
            "maxLength": 120
          },
          "rescuePhone": {
            "type": "string",
            "minLength": 0,
            "maxLength": 26
          },
          "rescueInstructions": {
            "type": "string",
            "minLength": 0,
            "maxLength": 2000
          }
        },
        "required": [
          "phone",
          "hours",
          "rescuePhone",
          "rescueInstructions"
        ],
        "additionalProperties": false
      },
      "SupportQuery": {
        "type": "object",
        "properties": {
          "sessionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          }
        },
        "required": [
          "sessionId"
        ],
        "additionalProperties": false
      },
      "SupportSend": {
        "type": "object",
        "properties": {
          "sessionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "text": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "orderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          }
        },
        "required": [
          "sessionId"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "text"
            ]
          },
          {
            "required": [
              "orderId"
            ]
          }
        ]
      },
      "SupportMessage": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "role": {
            "type": "string",
            "enum": [
              "user",
              "agent",
              "system"
            ]
          },
          "text": {
            "type": "string",
            "minLength": 0,
            "maxLength": 2000
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "orderId": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          }
        },
        "required": [
          "id",
          "role",
          "text",
          "createdAt"
        ],
        "additionalProperties": false
      },
      "SupportSession": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "status": {
            "type": "string",
            "enum": [
              "waiting",
              "connected",
              "closed"
            ]
          },
          "agentName": {
            "type": "string",
            "minLength": 0,
            "maxLength": 80
          },
          "messages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SupportMessage"
            },
            "maxItems": 200
          }
        },
        "required": [
          "id",
          "status",
          "agentName",
          "messages"
        ],
        "additionalProperties": false
      },
      "ChildDetails": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "age": {
            "type": "integer",
            "minimum": 0,
            "maximum": 17
          },
          "heightCm": {
            "type": "integer",
            "minimum": 30,
            "maximum": 220
          }
        }
      }
    }
  }
}
