📌 本指南提供文件上传功能的使用说明，包含请求格式、参数规范及示例代码。点击这里了解如何开始使用我们的API服务。

📝 基本概念

文件上传功能允许通过HTTP请求将数据文件传输至服务器，支持以下格式：

  • 📤 表单提交（multipart/form-data）
  • 📡 JSON数据流（application/json）

📷 上传流程示意图：

文件上传流程

🛠️ 使用步骤

  1. 准备文件：确保文件大小不超过5MB限制（如需扩展容量，请联系技术支持）
  2. 构造请求：
    POST /api/upload HTTP/1.1
Content-Type: multipart/form-data
  3. 参数说明：
    参数名 类型 必填 描述
    file 文件 是 需要上传的文件
    metadata JSON 否 文件附加信息

🚀 示例代码

📱 伪代码示例

let formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('metadata', JSON.stringify({type: 'document'}));

📷 上传界面示意图：

API请求示例

⚠️ 注意事项

  • 📉 大文件建议使用分片上传功能（详见分片上传文档）
  • ⚠️ 上传成功后会返回file_id，请妥善保存
  • 🔄 支持断点续传功能，需在请求头添加Range字段

📚 相关文档