获取当前用户的消息历史记录。
Request
HTTP request
POST https://www.featapi.com/api/party/message/history/
Parameters
无需添加参数。
Authorization
该请求需要授权以下scopes访问权限:
| Scopes |
|---|
| party_message |
For more information, see the authentication and authorization page.
Request body
In the request body, supply a Party.Message resource with the following properties:
| Property name | Value | Description | Notes |
|---|---|---|---|
| 选填 | |||
| max_id | integer | 消息ID的上限。 用于连续获取部分消息数据，避免重复消息和消息混淆问题。 | |
| since | integer | 消息ID的起始限制。用于连续获取部分消息数据，避免重复消息和消息混淆问题。 | |
| count | integer | 消息获取数量。 默认：20，建议不要超过50，可能造成访问报错。 | |
| group | integer | 指定群组ID，查询参数 | |
| user | integer | 指定用户ID，查询参数 | |
| message_type | enum | 指定消息类型 | Message.Message_type |
| is_archive | boolean | false为查询Inbox会话区域消息，true查询Archived归档区域消息 | |
| from_date | string | 指定消息发送的起始时间，查询参数 | 日期时间格式： YYYY-MM-DDThh:mm:ss |
| to_date | string | 指定消息发送的最后时间，查询参数 | 日期时间格式：YYYY-MM-DDThh:mm:ss |
| keywords | string | 关键字，查询参数。查询消息内容是否包含该关键字。 |
Response
如果请求成功，该API返回Party.Message消息数据列表在响应体信息。
200 Returns history list of party message successfully
{
"data": [
{
"id": 22568,
"from_user": 7815769374283,
"from_name": "WenWei Yang",
"to_user": 3616060330793,
"to_name": "zetong lin",
"to_group": null,
"content": "消息内容",
"message_type": 0,
"send_time": "2020-06-11T09:05:56.203982Z",
"location": "USA•New York",
"timezone": "America/New_York",
"detail": { }
}
]
}400 Validation Exception
示例返回数据可参考 API Common – Validation Exception