以流式分块方式上传文件到机器人本地(返回可用于发送的本地路径)

流式帧:分块确认 type=stream、完成 type=response(含 file_path/file_name/file_size/sha256)

授权

授权Bearer <token>

Authorization: Bearer <access_token>

位置: header

application/json

TypeScript 定义

在 TypeScript 中使用 request body 类型。

stream_id*string

流 ID(客户端生成的 UUID,限 [A-Za-z0-9_-])

长度1 <= length

chunk_data?string

分块数据(Base64)

chunk_index?integer

分块索引(从 0 开始)

范围0 <= value

total_chunks?integer

总分块数(新流必填)

范围1 <= value

file_size?integer

文件总大小(字节)

范围0 <= value

expected_sha256?string

期望的整文件 SHA256(校验)

is_complete?boolean

是否为最后一个分块/触发合并

filename?string

文件名

reset?boolean

重置并丢弃该流

verify_only?boolean

仅查询当前流状态

file_retention?integer

合并文件保留毫秒(0=不回收)

范围0 <= value

默认300000

[key: string]?any

curl -X POST "https://example.com/upload_file_stream" \  -H "Content-Type: application/json" \  -d '{    "stream_id": "string"  }'

{  "status": "ok",  "retcode": 0,  "data": null,  "message": "string",  "wording": "string"}