获取 Slack 的内容¶
GET /discussions/{discussion_id}/contents/¶
Retrieve the contents of a discussion by ID. A discussion can be a Slack or Discord chat.
Returns the content of the discussion with the specified ID. A discussion can be a Slack or Discord chat. The response contains two fields: discussion_content, which includes the main messages of the chat, and thread_contents, which contains the threads of the discussion.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
discussion_id |
path | integer | yes | The ID of the discussion to retrieve contents for. Discussions are either Slack or Discord chats. |
integration_type |
query | string | yes | Indicate the integration of the discussion. Currently, it can only be "slack" or "discord". |
from |
query | string | Indicate the starting time when we want to retrieve the content of the discussion in ISO 8601 format at GMT+0. If not specified, the default time is now. | |
to |
query | string | Indicate the ending time when we want to retrieve the content of the discussion in ISO 8601 format at GMT+0. If not specified, it is 7 days before the "from" parameter. |
Responses
200— Main and threaded messages of the discussion in a time range.404— Discussion not found.500— Internal server error.
示例请求¶
curl -X GET
"https://api.rememberizer.ai/api/v1/discussions/12345/contents/?integration_type=slack&from=2023-06-01T00:00:00Z&to=2023-06-07T23:59:59Z"
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Info
将 YOUR_JWT_TOKEN 替换为您的实际 JWT 令牌,并将 12345 替换为实际的讨论 ID。
const getSlackContents = async (discussionId, from = null, to = null) => {
const url = new URL(`https://api.rememberizer.ai/api/v1/discussions/${discussionId}/contents/`);
url.searchParams.append('integration_type', 'slack');
if (from) {
url.searchParams.append('from', from);
}
if (to) {
url.searchParams.append('to', to);
}
const response = await fetch(url.toString(), {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_JWT_TOKEN'
}
});
const data = await response.json();
console.log(data);
};
// 获取过去一周的 Slack 内容
const toDate = new Date().toISOString();
const fromDate = new Date();
fromDate.setDate(fromDate.getDate() - 7);
const fromDateStr = fromDate.toISOString();
getSlackContents(12345, fromDateStr, toDate);
Info
将 YOUR_JWT_TOKEN 替换为您的实际 JWT 令牌,并将 12345 替换为实际的讨论 ID。
import requests
from datetime import datetime, timedelta
def get_slack_contents(discussion_id, from_date=None, to_date=None):
headers = {
"Authorization": "Bearer YOUR_JWT_TOKEN"
}
params = {
"integration_type": "slack"
}
if from_date:
params["from"] = from_date
if to_date:
params["to"] = to_date
response = requests.get(
f"https://api.rememberizer.ai/api/v1/discussions/{discussion_id}/contents/",
headers=headers,
params=params
)
data = response.json()
print(data)
获取过去一周的 Slack 内容¶
to_date = datetime.now().isoformat() + "Z" from_date = (datetime.now() - timedelta(days=7)).isoformat() + "Z"
get_slack_contents(12345, from_date, to_date)
!!! info
将 `YOUR_JWT_TOKEN` 替换为您的实际 JWT 令牌,将 `12345` 替换为实际讨论 ID。
## 路径参数
| 参数 | 类型 | 描述 |
|----------------|---------|----------------------------------------|
| discussion_id | 整数 | **必填。** 要检索内容的 Slack 频道或讨论的 ID。 |
## 查询参数
| 参数 | 类型 | 描述 |
|-----------|------|-------------|
| integration_type | 字符串 | **必填。** 设置为 "slack" 以检索 Slack 内容。 |
| from | 字符串 | 以 ISO 8601 格式表示的起始时间,时区为 GMT+0。如果未指定,默认值为现在。 |
| to | 字符串 | 以 ISO 8601 格式表示的结束时间,时区为 GMT+0。如果未指定,则为 "from" 参数之前的 7 天。 |
## 响应格式
```json
{
"discussion_content": "用户 A [2023-06-01 10:30:00]: 早上好,团队!\n用户 B [2023-06-01 10:32:15]: 早上好!大家今天过得怎么样?\n...",
"thread_contents": {
"2023-06-01T10:30:00Z": "用户 C [2023-06-01 10:35:00]: @用户 A 我很好,谢谢关心!\n用户 A [2023-06-01 10:37:30]: 很高兴听到这个 @用户 C!",
"2023-06-02T14:15:22Z": "用户 D [2023-06-02 14:20:45]: 这是项目的更新...\n用户 B [2023-06-02 14:25:10]: 谢谢更新!"
}
}
错误响应¶
| 状态码 | 描述 |
|---|---|
| 404 | 找不到讨论 |
| 500 | 服务器内部错误 |
此端点检索 Slack 频道或直接消息对话的内容。它返回主要频道消息(discussion_content)和线程回复(thread_contents)。数据按时间顺序组织,并包含用户信息,使理解对话的上下文变得容易。
时间范围参数允许您专注于特定时期,这对于回顾近期活动或历史讨论特别有用。