跳到主要内容
Sursa Developers

对象

Upload

分段上传。

字段

  • idstring必填

    上传 ID（upl_ 后跟 32 个十六进制字符）。

  • purposeUploadPurpose必填
  • filenamestring必填

    文件名（不含文件夹）。

  • content_typestring必填

    声明的内容类型；未声明时为空。

  • sizeinteger (int64)必填

    文件大小（字节）。

  • sha256string | null必填

    文件的 SHA-256，在创建时或调用 complete 时声明；尚不知道时为 null。

  • statusUploadStatus必填
  • part_sizeinteger (int64)必填

    除最后一个分段外，每个分段的大小（5 到 100 MiB）。

  • part_countinteger必填

    分段数量。

    ≥ 1, ≤ 1000

  • parts_receivedinteger必填

    已接收的分段数量。

    ≥ 0

  • partsarray of UploadPart必填

    按编号列出的已接收分段（在 POST /v1/uploads 响应中为空）。

  • reject_reasonstring | null必填

    拒绝原因（rejected）：checksum_mismatch、type_mismatch、unsupported_format、infected、scan_unavailable、unsafe_content。该枚举可能扩充；未被拒绝时为 null。

  • reject_detailsobject | null必填

    拒绝的详细信息（扩展名、声明的格式和检测到的格式、校验和）；未被拒绝时为 null。

  • created_atstring (date-time)必填

    上传的创建时间。

  • expires_atstring (date-time)必填

    完成上传的截止时间，以及上传就绪后使用它的截止时间。

  • completed_atstring (date-time) | null必填

    检查完成的时间（ready 或 rejected）。

  • consumed_atstring (date-time) | null必填

    上传被使用的时间（被卡片、压缩包或导入使用）。

使用方