推进自己的已读位置（兼容路径）

将废弃

POST

/conversations/{conversation_id}/read-state

最后修改时间：2026-08-05 02:10:17

与 POST /conversations/{conversation_id}/read 完全相同。

请求参数

Authorization

OAuth 2.0

Authorization Code

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Authorize URL: https://api.yearnstudio.cn/oauth/authorize

Token URL: https://api.yearnstudio.cn/oauth/token

OAuth 2.0

Authorization Code

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Authorize URL: https://api.yearnstudio.cn/oauth/authorize

Token URL: https://api.yearnstudio.cn/oauth/token

Scopes:

im-旧版即时通讯写入权限

Path 参数

Body 参数application/json

示例

{
    "last_id": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.yearnstudio.cn/conversations/018f274a-86e6-7ef1-b610-77cb15af52bd/read-state' \
--header 'Content-Type: application/json' \
--data '{
    "last_id": 0
}'

返回响应

🟢200

application/json

更新后的已读状态。

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "last_id": 0
    }
}

🟠400BadRequest

🟠401Unauthorized

🟠403WriteForbidden

🟠404NotFound

🔴500InternalError

🔴503ServiceUnavailable

修改于 2026-08-05 02:10:17

获取自己的已读状态（兼容路径）

增量同步会话和消息变化