分页读取任务内解析原文¶
分页读取任务内解析原文。
POST https://api.moi.matrixorigin.cn/v5/semantic-models/runtime/read-document
调用前准备¶
仅在当前任务执行环境使用注入的服务地址、技术凭据、工作区和短期授权;保留授权头原值。普通 PAT 不能替代任务身份或建立授权。示例使用 jq;变量、对象与状态见公共说明。
请求体¶
curl -X POST "${MOI_ENDPOINT%/}/semantic-models/runtime/read-document" \
-H "X-API-Key: $MOI_API_KEY" \
-H "X-Workspace-ID: $MOI_WORKSPACE_ID" \
-H "X-MOI-Runtime-Authorization: $MOI_RUNTIME_AUTHORIZATION" \
-H 'Content-Type: application/json' \
--data-binary "$(jq -n --arg REQUEST_ID "$REQUEST_ID" --arg MARKDOWN_FILE_ID "$MARKDOWN_FILE_ID" '
{
"request_id": $REQUEST_ID,
"markdown_file_id": $MARKDOWN_FILE_ID,
"cursor": 0,
"limit_chars": 4000
}
')"
读取当前授权来源的有效分段重建文本。用 next_cursor 继续,为 0 时结束;本动作没有证据窗口的 has_more。不要按字节数计算偏移,也不要推算 Markdown 文件 ID。
字段 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
是 |
本次操作的唯一 ID,1–256 字节,无首尾空白,不以 audit: 开头;重放同一输入时保留原值。 |
|
string |
是 |
原证据返回的 Markdown 定位 ID。 |
|
integer |
否 |
Unicode 字符偏移,默认 0,不接受负数。 |
|
integer |
否 |
非正值或省略使用 8000,最大 20000。 |
成功响应¶
{
"code": "OK",
"msg": "OK",
"data": {
"call_id": "request_example",
"output": {
"markdown_file_id": "markdown_example",
"file_name": "example.md",
"total_chars": 4,
"cursor": 0,
"returned_chars": 4,
"next_cursor": 0,
"content": "示例原文",
"metadata": {}
}
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
成功时为 OK。 |
|
string |
响应说明。 |
|
string |
对应原 request_id。 |
|
boolean |
true 表示业务失败;false 时可省略。 |
|
object |
当前操作结果。 |
|
object(对象数组) |
同一任务的原始产物与证据。 |
|
object |
操作元数据,存在时返回。 |
|
string |
当前操作返回的原始值,按公共对象说明保留。 |
|
string |
当前操作返回的原始值,按公共对象说明保留。 |
|
integer |
当前操作返回的原始值,按公共对象说明保留。 |
|
integer |
当前操作返回的原始值,按公共对象说明保留。 |
|
integer |
当前操作返回的原始值,按公共对象说明保留。 |
|
integer |
按当前读取模式继续;Markdown 为 0 时结束。 |
|
string |
当前窗口原文。 |
|
object |
当前操作返回的原始值,按公共对象说明保留。 |
错误响应¶
按 HTTP 状态、业务结果和错误字段处理,见错误与环境。来源与版本冲突时读取当前状态,不替换身份、资源或请求 ID 自动重试。