# 读消息

## <mark style="color:green;">POST</mark> api/v1/message/read

* 说明：更新已读取消息数。
* Header

| Field         | Type   | Remarks                                                                                        |
| ------------- | ------ | ---------------------------------------------------------------------------------------------- |
| ApiKey        | String | 从管理员获取的[ApiKey](https://relationlabs.gitbook.io/relation-one-api/api-zh/guide/glossary#apikey) |
| Authorization | String | Bearer ${unifiedAuthToken} ,其中unifiedAuthToken来自/api/v1/auth接口的返回                              |

* Request Parameters

| Field       | Type   | Remarks   |
| ----------- | ------ | --------- |
| channelUuid | String | 群组uuid    |
| total       | int    | 当前已读取的消息数 |

* Request Example

```shell
curl POST 'https://api.relationlabs.ai/api/v1/message/read' \
--header 'ApiKey: <ApiKey>' \
--header 'Authorization: bearer eyJhbG1ciOiJFUzI1NiJ9.eyJqdGkiOiI0MzdiN2EzZDEwMGY0ODVkOWVhMWUzZmZlOWE1NmEyZSIsImlzcyI6InJlbGF0aW9ubGFicy5haSIsImlhdCI6MTY2NTIxNTUzNSwic3ViIjoiZGhreXEtc3FhYWEtYWFhYWotc2d6M3EtY2FpIiwiZXhwIjoxNjY11ODIwMzM1fQ.rj7KKuIcgmvaIwZ63YHnXQ4jvvI-eR2Wo7k3YEyzM1uxo8j5ezCowKDpcW0u9zIuHPFqwD0-1XPWdPLR1d1HLFw' \
--header 'Content-Type: application/json' \
--data-raw '{
    "channelUuid": "4f326124812c41448bc587bf6b2eaf42",
    "total": 20
}'
```

* Response Parameters

| Field | Type   | Remarks             |
| ----- | ------ | ------------------- |
| code  | String | 返回码                 |
| desc  | String | 返回信息                |
| data  | int    | 更新结果： 1-已更新，其他-更新失败 |

* Response Body

```json
{
    "code": "0",
    "desc": "success",
    "data": 1
}
```

* Return Code

| code | desc    | Remarks |
| ---- | ------- | ------- |
| 0    | success | 接口调用成功  |