查询最近 UI 协议消息 ID¶
读取当前用户在指定会话内的最大消息 ID。
GET https://api.moi.matrixorigin.cn/v5/messages/sessions/{session_id}/latest
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
配置同环境的身份、工作区和数值记录 ID。该入口采用普通产品身份认证,附加的任务运行期授权头会被拒绝。
请求¶
curl --request GET \
"$BASE_URL/messages/sessions/$SESSION_ID/latest" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
请求头 |
string |
是 |
目标工作区 ID。 |
|
路径 |
integer |
是 |
当前用户记录的正整数 ID。 |
没有匹配消息时 message_id 为 0;不独立验证会话存在。此入口不读取 completed_only,不能用查询参数把它变成只读 completed 的工作区最近消息接口。
成功响应¶
{
"code": "OK",
"msg": "OK",
"data": {
"session_id": 41,
"message_id": 71
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
成功为 OK;HTTP 状态码为 200。 |
|
string |
成功为 OK。 |
|
integer |
请求中的会话 ID。 |
|
integer |
最大消息 ID;无匹配消息时为 0。 |
错误响应¶
错误格式和结果确认区分会话详情的 not-found 与其他入口的通用服务错误。
最后更新于