通过API上传文档

关于在线调试与示例代码

您可以在线调试ApplyFileUploadLease接口，并实时生成多语言（例如Java、Node.js等）代码示例。

此接口请求参数中的FileName字段的值须与即将上传的文档名一致

ApplyFileUploadLease接口请求参数中的FileName字段表示您即将上传的文档的名称（包括后缀），该字段的值必须与实际文档名一致，否则接口会报错。例如，您准备上传一个名为百炼系列手机产品介绍.docx的文档：

相应的FileName传入示例如下：

百炼系列手机产品介绍.docx

关于此接口请求参数中的MD5字段的值

ApplyFileUploadLease接口请求参数中的Md5字段表示您即将上传的文档的MD5值（用于验证文档是否完整），您可以使用Python的hashlib模块或Java的MessageDigest类获取该值。

您可以展开下方折叠面板查看Python和Java的示例代码（其他语言需要您参照示例代码自行编写）。

# 示例代码仅供参考，请勿在生产环境中直接使用
import hashlib
def calculate_md5(file_path):
    """计算文档的 MD5 值。

    Args:
        file_path (str): 文档的路径。

    Returns:
        str: 文档的 MD5 值。
    """
    md5_hash = hashlib.md5()

    # 以二进制形式读取文件
    with open(file_path, "rb") as f:
        # 按块读取文件，避免大文件占用过多内存
        for chunk in iter(lambda: f.read(4096), b""):
            md5_hash.update(chunk)

    return md5_hash.hexdigest()

# 使用示例
file_path = "请替换为您需要上传文档的实际本地路径，例如/Users/Bailian/Desktop/百炼系列手机产品介绍.docx"
md5_value = calculate_md5(file_path)
print(f"文档的MD5值为: {md5_value}")

// 示例代码仅供参考，请勿在生产环境中直接使用
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.security.MessageDigest;

public class Md5Utils {

    private static String getFileMd5(String filePath) throws Exception {
        MessageDigest digest = MessageDigest.getInstance("MD5");
        try (InputStream is = Files.newInputStream(Paths.get(filePath))) {
            byte[] buffer = new byte[1024];
            int read;
            while ((read = is.read(buffer)) > 0) {
                digest.update(buffer, 0, read);
            }
        }
        byte[] md5Bytes = digest.digest();

        StringBuilder md5String = new StringBuilder();
        for (byte b : md5Bytes) {
            md5String.append(String.format("%02x", b));
        }

        return md5String.toString();
    }

    public static void main(String[] args) throws Exception {

        String filePath = "请替换为您需要上传文档的实际本地路径，例如/Users/Bailian/Desktop/百炼系列手机产品介绍.docx";
        String md5 = getFileMd5(filePath);

        System.out.println("文档的MD5值为: " + md5);
    }
}

运行上述示例代码，您即可得到目标文档的MD5值（以下示例值仅供参考）：

文档的MD5值为: c0c07fb456057128540a91ea9b06666c

成功调用ApplyFileUploadLease接口的响应示例

• 此接口响应中的Data.FileUploadLeaseId、Data.Param.Method、Data.Param.Url、Data.Param.Headers中X-bailian-extra和Content-Type字段的值请妥善保存，它们将用于后续的上传步骤。

• 此接口响应中的Data.Param.Url字段的值（即租约）有效期为分钟级，请尽快上传文档，以免租约过期导致无法上传。

{
  "RequestId": "778C0B3B-59C2-5FC1-A947-36EDD1xxxxxx",
  "Success": true,
  "Message": "",
  "Code": "success",
  "Status": "200",
  "Data": {
    "FileUploadLeaseId": "1e6a159107384782be5e45ac4759b247.1719325231035",
    "Type": "HTTP",
    "Param": {
      "Method": "PUT",
      "Url": "https://bailian-datahub-data-origin-prod.oss-cn-hangzhou.aliyuncs.com/1005426495169178/10024405/68abd1dea7b6404d8f7d7b9f7fbd332d.1716698936847.pdf?Expires=1716699536&OSSAccessKeyId=TestID&Signature=HfwPUZo4pR6DatSDym0zFKVh9Wg%3D",
      "Headers": "        \"X-bailian-extra\": \"MTAwNTQyNjQ5NTE2OTE3OA==\",\n        \"Content-Type\": \"application/pdf\""
    }
  }
}

不支持在线调试

由于本步骤的代码目前并未包含在SDK中，因此不支持在线调试和多语言示例代码的自动生成（需要您参照下方的示例代码自行手动编写）。

关于示例代码中的pre_signed_url参数

下方示例代码中的pre_signed_url是您在上一步（申请文档上传租约）中调用ApplyFileUploadLease接口实际返回的Data.Param中Url字段的值。

关于在线调试与示例代码

您可以在线调试AddFile接口，并实时生成多语言代码示例。

关于此接口请求参数中的LeaseId字段

AddFile接口请求参数中的LeaseId字段的值为之前步骤（申请文档上传租约）中调用ApplyFileUploadLease接口返回的Data.FileUploadLeaseId字段的值。

请勿重复提交

AddFile接口调用成功后，LeaseId（租约 ID）随即失效，请勿使用相同的租约 ID 重复提交。

关于在线调试与示例代码

您可以在线调试DescribeFile接口，并实时生成多语言代码示例。

存储期限

导入数据管理的文档仅用于最终导入知识库前的临时存储，有效期为90天，不支持长期保存，请自行妥善保存原文档。