{
  "openapi": "3.0.3",
  "info": {
    "title": "文档格式转换",
    "description": "文档转换系列 API，支持多格式互转：Word、Markdown、HTML、PDF、Excel、CSV，满足文档解析、渲染导出、内容提取等场景。",
    "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://route.showapi.com"
    }
  ],
  "paths": {
    "/3604-1": {
      "x-pointCode": 1,
      "x-mode": "mapping",
      "x-read-timeout": 60,
      "x-connect-timeout": 60,
      "post": {
        "summary": "通用文档格式转换",
        "description": "支持以下方案的格式转换：\nword2md：将 Word 文档转换为 Markdown 格式。\nmd2pdf：将 Markdown 文件转换为 PDF 文档。\nweb2md：将网页或 HTML 内容转换为 Markdown 格式。\nmd2html：将 Markdown 文件转换为 HTML 网页代码。\nmd2docx：将 Markdown 文件转换为 Word 文档。\nhtml2pdf：将 HTML 网页内容直接转换为 PDF 文档。\nexcel2csv：将 Excel 表格文件转换为 CSV 纯文本格式。\ncsv2excel：将 CSV 纯文本数据转换为 Excel 表格文件。\npdf2text：提取 PDF 文档内容并转换为 Markdown 文本。\npdf2img：将 PDF 文档的每一页分别转换为独立的图片文件。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "成功标识：0为成功，其余为失败"
                            },
                            "out_url": {
                              "type": "string",
                              "description": "转换成功后的地址"
                            },
                            "remark": {
                              "type": "string",
                              "description": "执行失败时的提示信息"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "3604_1_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "file_url": {
                    "type": "string",
                    "description": "原文档url，和base64二选一"
                  },
                  "file_base64": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 5000000,
                    "description": "原文档base64，和url二选一"
                  },
                  "out_format": {
                    "type": "string",
                    "description": "转化后的格式，支持：md、pdf、html、docx"
                  }
                },
                "required": [
                  "out_format"
                ]
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AppKeyAuth": {
        "type": "apiKey",
        "in": "query",
        "name": "appKey",
        "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp"
      }
    },
    "schemas": {
      "ShowapiResEnvelope": {
        "type": "object",
        "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）",
        "properties": {
          "showapi_res_code": {
            "type": "integer",
            "description": "API 返回的状态码"
          },
          "showapi_res_error": {
            "type": "string",
            "description": "API 返回的错误信息"
          },
          "showapi_res_id": {
            "type": "string",
            "description": "API 请求的唯一标识"
          },
          "showapi_fee_num": {
            "type": "integer",
            "description": "API 调用计费次数"
          }
        }
      }
    }
  },
  "security": [
    {
      "AppKeyAuth": []
    }
  ],
  "externalDocs": {
    "url": "https://www.showapi.com/apiGateway/view/3604?tab=book"
  },
  "x-apiCode": "3604",
  "x-is-own": false,
  "x-is-op": false
}