推进自己的已读位置

POST

/conversations/{conversation_id}/read

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

已读位置只能单调向前推进，重复提交是幂等的。省略 last_id 或传 null
时推进到当前最新消息。若请求值大于当前最新消息 ID，服务器会将其限制为
当前最新消息 ID。响应返回最终存储的位置。

请求参数

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' \
--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

获取自己的已读状态

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