文件管理

文件上传地址有效期是多久？

文件上传地址，链接有效期60分钟。

通过taskId查询文件合成任务， 提示“文件转换失败：网络地址访问失败”

当出现文档转换超时的情况时，往往会致使文件合成失败。此时，您可以重新调用模板来生成文件，随后再调用查询文件合成任务接口，查看此次文件合成是否成功。倘若经过上述操作后，文件合成依旧失败，那么您可以直接联系技术人员，由专业的技术人员来协助您解决这一问题。

调用获取文件上传地址和文件直传参数都正确无误，但是文件直传仍然报"403 Forbidden: "<?xml version="1.0" encoding="UTF-8"?><EOL><Error><EOL> <Code>SignatureDoesNotMatch</Code><EOL> <Message>The request signature we calculated does not match the signature you provided. Check your key and signing method.</Message><EOL> <RequestId>68440537821143343409E1E9</RequestId><EOL>"

若步骤一中传参的contentType与步骤二 Header 中传输的Content-Type一致，且通过 Postman 调用fileUploadUrl直传文件成功，但代码调用时仍报错，经断点检查参数传递无误，可能是框架应用存在兼容性问题。建议参考以下代码示例进行文件直传：

参考代码：

// 调用方式（以Java为例）
Response response = HttpUtil.sendRequest(
    "uploadUrl",                // 上传接口URL
    new File("文件路径/xxx.pdf"), // 待上传文件
    "application/pdf",          // 内容类型
    new HashMap<>()             // 可选请求头参数（若无则传空）
);

关键说明：

1. 参数一致性验证：确保代码中Content-Type参数（如"application/pdf"）与接口要求完全一致，包括大小写和格式（如application/json需与application/JSON严格区分）。
2. 框架兼容性排查：若代码逻辑无误但仍报错，可尝试绕过客户框架，直接使用原生 HTTP 客户端（如 Java 的URLConnection、Python 的requests）验证，定位是否为框架对请求头、文件流处理的兼容性问题。
3. 错误日志定位：建议客户捕获并记录完整错误信息（如 HTTP 状态码、服务器返回报文），以便进一步排查网络层或服务器端的具体报错原因。

此方案通过标准化参数传递和简化调用链路，可有效隔离框架问题，快速定位文件直传失败的根源。