读取连接器临时文件流¶
使用连接器临时文件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"
字段 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
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、机器码与实际诊断,不套其他文件协议错误包。
最后更新于