读取连接器临时文件流

使用连接器临时文件ID读取已保存的文件字节。

GET https://api.moi.matrixorigin.cn/v5/connectors/file/stream

调用前准备

BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

准备同一环境的产品凭据MOI_KEY和WORKSPACE_ID;BASE_URL包含产品前缀。所有ID从实际查询结果取得,示例数据仅展示结构。

请求参数

curl --fail-with-body -sS "$BASE_URL/connectors/file/stream?conn_file_id=$CONN_FILE_ID" \
  -H "X-API-Key: $MOI_KEY" -H "X-Workspace-ID: $WORKSPACE_ID" \
  -o "$OUTPUT_FILE"

字段

类型

是否必填

说明

conn_file_id

string

是

查询参数,来自临时文件上传/预览或下载地址响应。

需要同一环境的产品身份和工作区。下载地址是相对路径,保留实际返回的完整路径及查询参数;它不是签名单文件能力链接。Content-Type为application/octet-stream,附件名来自持久化的临时文件名。

成功响应

HTTP/1.1 200 OK
<binary file content>

字段/响应项

类型

说明

响应体

bytes(字节流)

读取完毕并关闭流;出现错误时不能将部分内容当作完整文件。

成功响应没有统一code/data外层;临时文件和图片流直接返回字节。

错误响应

{
  "code": "ErrNotFound",
  "msg": "示例本地化错误"
}

HTTP

code/形式

条件

400

无响应体

conn_file_id查询参数缺失。

404

ErrNotFound

临时记录或底层对象不存在。

403

ErrForbidden

权限拒绝。

503

ErrServiceUnavailable

其他临时文件依赖不可用。

外层身份/任务证明的拒绝还可能先于此handler;保持原始HTTP、机器码与实际诊断,不套其他文件协议错误包。

最后更新于