# 读取连接器临时文件流

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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

```text
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从实际查询结果取得，示例数据仅展示结构。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
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"
```

:::::
:::::{tab-item} 参数说明

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `conn_file_id` | string | 是 | 查询参数，来自临时文件上传／预览或下载地址响应。 |

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

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```text
HTTP/1.1 200 OK
<binary file content>
```

:::::
:::::{tab-item} 字段说明

| 字段／响应项 | 类型 | 说明 |
| --- | --- | --- |
| `响应体` | bytes（字节流） | 读取完毕并关闭流；出现错误时不能将部分内容当作完整文件。 |

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

:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| HTTP | code／形式 | 条件 |
| --- | --- | --- |
| 400 | 无响应体 | conn_file_id查询参数缺失。 |
| 404 | ErrNotFound | 临时记录或底层对象不存在。 |
| 403 | ErrForbidden | 权限拒绝。 |
| 503 | ErrServiceUnavailable | 其他临时文件依赖不可用。 |

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

:::::
::::::
:::::::
