{
  "openapi": "3.1.0",
  "info": { "title": "蔡小杰技能库", "version": "1.0.0" },
  "servers": [{ "url": "https://skill.caixiaojie.com" }],
  "paths": {
    "/api/v1/skills.json": {
      "get": { "operationId": "listSkills", "summary": "读取公开技能、指南地址及运行状态", "responses": { "200": { "description": "技能索引" } } }
    },
    "/api/v1/itinerary/preflight": {
      "post": {
        "operationId": "preflightItinerary",
        "summary": "电子行程单资料预检",
        "description": "仅传日期、人数和资料具备标记。证件、名单原文、密码及其他凭证请经私有渠道管理。此操作返回缺项和路由，不生成或提交官方行程单。",
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": {
            "type": "object", "additionalProperties": false,
            "required": ["platform", "departureDate", "returnDate", "passengerCount", "materials"],
            "properties": {
              "platform": { "const": "national", "description": "电子行程单仅使用全国旅游监管服务平台。" },
              "departureDate": { "type": "string", "format": "date" },
              "returnDate": { "type": "string", "format": "date" },
              "passengerCount": { "type": "integer", "minimum": 1, "maximum": 10000 },
              "materials": {
                "type": "object", "additionalProperties": false,
                "required": ["plan", "passengerList", "guide", "vehicle", "itinerary", "hotels"],
                "properties": {
                  "plan": { "type": "boolean" }, "passengerList": { "type": "boolean" },
                  "guide": { "type": "boolean" }, "vehicle": { "type": "boolean" },
                  "itinerary": { "type": "boolean" }, "hotels": { "type": "boolean" }
                }
              }
            }
          } } }
        },
        "responses": {
          "200": { "description": "资料缺项和办理状态" },
          "400": { "description": "JSON 格式错误" },
          "413": { "description": "请求超过大小限制" },
          "415": { "description": "请使用 application/json" },
          "422": { "description": "字段无效或有额外字段" }
        }
      }
    }
  }
}
