文件管理

文件上傳地址有效期是多久?

文件上傳地址，鏈接有效期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 狀態碼、伺服器返回報文），以便進一步排查網絡層或伺服器端的具體報錯原因。

此方案通過標準化參數傳遞和簡化調用鏈路，可有效隔離框架問題，快速定位文件直傳失敗的根本原因。