APIHUB

深色模式

接口文档 ​

调用示例 ​

sh
POST https://open.apihub.net/api/docx-template/render
apihub-token: {{ apihub_token }}

{
    "template": "https://dl.apihub.net/docx-template/常规费用报销单.docx",
    "filename": "常规费用报销单",
    "vars": {
        "code": "code123",
        "company": "apihub.net",
        "department": "open",
        "date": "2025-04-18",
        "user_name": "张三",
        "费用归属项目": "一个大型的项目",
        "收款账号": "6214830112345678",
        "收款银行": "招商银行北京北三环支行",
        "合计金额": "377.56",
        "合计金额大写": "叁佰柒拾柒元伍角陆分",
        "财务经理": "赵六",
        "会计": "王五",
        "部门经理": "李四",
        "经办人": "张三",
        "明细": [
            {
                "摘要": "笔x1",
                "金额": "123.00",
                "科目": "其他",
                "附单据数": 1
            },
            {
                "摘要": "墨x2",
                "金额": "234.56",
                "科目": "其他",
                "附单据数": 1
            },
            {
                "摘要": "纸x3",
                "金额": "20.00",
                "科目": "其他",
                "附单据数": 1
            }
        ]
    }
}
sh
curl -X POST \
  "https://open.apihub.net/api/docx-template/render" \
  -H "apihub-token: {{ apihub_token }}" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "https://dl.apihub.net/docx-template/常规费用报销单.docx",
    "filename": "常规费用报销单",
    "vars": {
        "code": "code123",
        "company": "apihub.net",
        "department": "open",
        "date": "2025-04-18",
        "user_name": "张三",
        "费用归属项目": "一个大型的项目",
        "收款账号": "6214830112345678",
        "收款银行": "招商银行北京北三环支行",
        "合计金额": "377.56",
        "合计金额大写": "叁佰柒拾柒元伍角陆分",
        "财务经理": "赵六",
        "会计": "王五",
        "部门经理": "李四",
        "经办人": "张三",
        "明细": [
            {
                "摘要": "笔x1",
                "金额": "123.00",
                "科目": "其他",
                "附单据数": 1
            },
            {
                "摘要": "墨x2",
                "金额": "234.56",
                "科目": "其他",
                "附单据数": 1
            },
            {
                "摘要": "纸x3",
                "金额": "20.00",
                "科目": "其他",
                "附单据数": 1
            }
        ]
    }
}'

参数说明 ​

参数位置类型必传说明
templateJsonBodystr是docx模板文件的url地址，apihub后端服务将下载该文件进行渲染
varsJsonBodydict是变量，用于替换模板文件中占位符
filenameJsonBodystr否指定返回值中生成文件的文件名，不指定时文件名将是一个随机字符串

模板 docx 文件示例：https://dl.apihub.net/docx-template/常规费用报销单.docx

返回值说明 ​

返回结果文件的下载地址。

下载地址中 /temp1d/ 前缀表示该文件是有效期一天的临时文件。

可以使用微软的web服务 https://view.officeapps.live.com/op/view.aspx?src=${response.data.result} 进行预览。

{>...3
    "success": true,
    "trace": "a0f541e021b611f0956cc6807b612ccf",
    "result": "https://dl.apihub.net/temp1d/a5759d12c5684758b31aa93c51e40abb.docx"
}