ファイル管理

ファイルアップロードアドレスの有効期間はどのくらいですか？

ファイルアップロードアドレス、リンクの有効期間は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>」を報告します

ステップ1でパラメータを渡すcontentTypeステップ2のヘッダーで送信されたものと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ステータスコード、サーバーから返されるメッセージなど）をキャプチャして記録することをお勧めします。

このソリューションは、パラメータの受け渡しを標準化し、呼び出しチェーンを簡素化することで、フレームワークの問題を効果的に分離し、ファイルのダイレクトアップロードの失敗の根本原因を迅速に特定できます。