Read a temporary connector file stream¶
Read stored file bytes using a temporary connector file ID.
GET https://api.moi.matrixorigin.cn/v5/connectors/file/stream
Before you call this API¶
Set BASE_URL to the product API prefix https://api.moi.matrixorigin.cn/v5. For private deployments, use the corresponding product API URL.
Prepare product credential MOI_KEY and WORKSPACE_ID in the same environment. BASE_URL includes the product prefix. Obtain all IDs from actual query results; example data illustrates structure only.
Request parameters¶
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"
Field |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes |
Query parameter from temporary-file upload/preview or download-URL responses. |
Requires product identity and Workspace in the same environment. Download URLs are relative paths; retain the actual complete returned path and query parameters. These are not signed single-file capability links. Content-Type is application/octet-stream; the attachment name comes from the persisted temporary file name.
Successful response¶
HTTP/1.1 200 OK
<binary file content>
Field/response item |
Type |
Description |
|---|---|---|
|
bytes (byte stream) |
Read to completion and close the stream. Do not treat partial content after an error as a complete file. |
Successful responses have no uniform code/data wrapper; temporary files and image streams return bytes directly.
Error responses¶
{
"code": "ErrNotFound",
"msg": "示例本地化错误"
}
HTTP |
code/format |
Condition |
|---|---|---|
400 |
No response body |
Missing conn_file_id query parameter. |
404 |
ErrNotFound |
Temporary record or underlying object missing. |
403 |
ErrForbidden |
Permission denied. |
503 |
ErrServiceUnavailable |
Other temporary-file dependencies unavailable. |
Outer identity/task-proof rejection may precede this handler. Retain raw HTTP, machine codes, and actual diagnostics; do not apply other file-protocol error envelopes.