消息列表
GET api/v1/message/list
说明:查询某个群组内的消息列表,根据消息发送时间倒序排列。仅当前群组内成员可查看。
Header
Authorization
String
Bearer ${unifiedAuthToken} ,其中unifiedAuthToken来自/api/v1/auth接口的返回
Request Parameters
channelUuid
String
选填,与toRelationId 至少有一个不为空。群组uuid
toRelationId
String
选填,与channelUuid 至少有一个不为空。对方的relationId
maxCreateAt
long
时间戳,毫秒为单位。需要大于或等于当前页最后一条消息的发送时间
limit
int
每页返回的数据
Request Example
curl POST 'https://api.relationlabs.ai/api/v1/message/list?channelUuid=4f326124812c41448bc587bf6b2eaf42&maxCreateAt=1665370135000&limit=10' \
--header 'ApiKey: <ApiKey>' \
--header 'Authorization: bearer eyJhbGciO1iJFUzI1NiJ9.eyJqdGkiOiI0MzdiN2EzZDEwMGY0ODVkOWVhMWUzZmZlOWE1NmEyZSIsImlzcyI6InJlbGF0aW9ubGFicy5haSIsImlhdCI6MTY2NTIxNTUzNSwic3ViIjoiZGhreXEtc3FhYWEtYWFhYWotc2d6M3EtY2FpIiwiZXhwIjoxNjY1ODI1wMzM1fQ.rj7KKuIcgmvaIwZ63YHnXQ4jvvI-eR2Wo7k3YEyzMux1o8j5ezCowKDpcW0u9zIuHPFqwD0-1XPWdPLR1d1HLFw'
Response Parameters
code
String
返回码
desc
String
返回信息
data
Array[MessageInfo]
数据
The MessageInfo field consists of the following subfields:
id
String
消息的唯一id
sendUuid
String
消息的uuid,由客户端生成维护
channelUuid
String
群组的uuid
createAt
String
消息发送时间,时间戳(单位:毫秒)
type
String
消息类型
from
String
发送者的relationId
fromName
String
发送者的名称
fromAvatar
String
发送者的头像
content
String
消息内容
quote
MessageInfo
引用的消息
Response Body
{
"code": "0",
"desc": "success",
"data": [
{
"id": "1578671129496899586",
"sendUuid": "8e7c082f-9a96-405a-b946-7f465048f354",
"channelUuid": "4f326124812c41448bc587bf6b2eaf42",
"createAt": "1665219502000",
"type": "SYS",
"from": "00000000000000000000000000000000",
"fromName": null,
"fromAvatar": null,
"content": "0x1e56 created Group test-group",
"quote": null
}
...
]
}
Return Code
0
success
接口调用成功
10112
parameter error
channelUuid和toRelationId不能同时为空
10120
permission denied
无权限查看
Last updated