获取热点话题列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
-
操作:是指具体的权限点。
-
访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
-
资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
- 对于不支持资源级授权的操作,用
全部资源表示。
-
条件关键字:是指云产品自身定义的条件关键字。
-
关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
aimiaobi:ListHotTopics | list | *全部资源
| 无 | 无 |
请求语法
POST HTTP/1.1
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| AgentKey | string | 是 | 业务空间唯一标识: AgentKey | xxxxx_p_efm |
| TopicSource | string | 否 | 热榜源筛选,支持的热榜源。热榜源详见 API:ListHotSources Aggregation:表示 聚合后的全国热点话题榜 | Quark |
| Topics | array | 否 | 热榜主题事件筛选 | |
string | 否 | 热榜主题事件名称 | xxx | |
| TopicVersion | string | 否 | 数据版本筛选 | 数据版本筛选 |
| TopicQuery | string | 否 | 根据热榜主题全文检索 | 根据热榜主题全文检索 |
| TopicIds | array | 否 | 热榜主题 ID 列表 | |
string | 否 | 热榜主题 ID | xxxxxx | |
| WithNews | boolean | 否 | 响应是否包含新闻 | true |
| NextToken | string | 否 | 下一页的 token | 下一页的token |
| MaxResults | integer | 否 | 最大返回结果数 | 1 |
| CustomField | string | 否 | 自定义业务字段筛选(keyword 精确匹配),长度上限 255 字符 | biz-tag-001 |
| CreateTimeStart | string | 否 | 话题创建时间筛选起点(包含),格式:yyyy-MM-dd HH:mm:ss | 2026-06-01 00:00:00 |
| CreateTimeEnd | string | 否 | 话题创建时间筛选终点(包含),格式:yyyy-MM-dd HH:mm:ss | 2026-06-04 23:59:59 |
返回参数
名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
object | PageResult2 | ||
| Code | string | 状态码 | NoData |
| Data | array<object> | 业务数据 | |
array<object> | 热点事件列表 | ||
| AsyncTaskId | string | 异步任务 ID(自定义主题场景下使用) | 异步任务ID(自定义主题场景下使用) |
| CreateUser | string | 创建用户 ID(自定义主题场景下使用) | 创建用户ID(自定义主题场景下使用) |
| HotValue | integer | 热度值 | 61 |
| Id | string | 热榜 ID | 热榜ID |
| Status | string | 异步任务状态(自定义事件场景下使用) (PENDING: 待执行, RUNNING: 执行中, SUCCESSED: 成功, SUSPENDED: 暂停, FAILED: 失败, CANCELED: 取消) | FAILED |
| StructureSummary | array<object> | 结构化主题摘要列表 | |
array<object> | |||
| DocList | array<object> | 生成该标题摘要引用的文章 | |
object | |||
| Source | string | 文章来源 | 夸克 |
| Title | string | 文章标题 | xxxxx |
| Url | string | 文章 URL | |
| Summary | string | 摘要 | 摘要 |
| Title | string | 标题 | 标题 |
| Summary | string | 热榜摘要 | 热榜摘要 |
| TaskErrorMessage | string | 异步任务失败错误信息 | 异步任务失败错误信息 |
| TaskStatus | integer | 异步任务状态。0-待执行,1-执行中,2-执行成功,3-暂停(暂不使用),4-执行失败,6-任务取消(自定义事件场景下使用) | 26 |
| Topic | string | 主题唯一名称 | 主题唯一名称 |
| TopicSource | string | 热榜源,目前支持的热榜源:
| Toutiao |
| Version | string | 数据版本 | 数据版本 |
| CustomField | string | 自定义业务字段(keyword) | biz-tag-001 |
| CreateTime | string | 话题创建时间,格式:yyyy-MM-dd HH:mm:ss | 2026-06-04 12:34:56 |
| TopicUrl | string | 话题原文链接 | |
| HttpStatusCode | integer | http 状态码 | 200 |
| MaxResults | integer | 最大返回结果数 | 94 |
| Message | string | 错误说明 | success |
| NextToken | string | 下一页的 token | 下一页的token |
| RequestId | string | 请求唯一标识 | 1813ceee-7fe5-41b4-87e5-982a4d18cca5 |
| Success | boolean | 是否成功:true 成功,false 失败 | true |
| TotalCount | integer | 总数 | 23 |
示例
正常返回示例
JSON格式
{
"Code": "NoData",
"Data": [
{
"AsyncTaskId": "异步任务ID(自定义主题场景下使用)",
"CreateUser": "创建用户ID(自定义主题场景下使用)",
"HotValue": 61,
"Id": "热榜ID",
"Status": "FAILED",
"StructureSummary": [
{
"DocList": [
{
"Source": "夸克",
"Title": "xxxxx",
"Url": "http://www.example.com"
}
],
"Summary": "摘要",
"Title": "标题"
}
],
"Summary": "热榜摘要",
"TaskErrorMessage": "异步任务失败错误信息",
"TaskStatus": 26,
"Topic": "主题唯一名称",
"TopicSource": "Toutiao",
"Version": "数据版本",
"CustomField": "biz-tag-001",
"CreateTime": "2026-06-04 12:34:56",
"TopicUrl": "https://www.example.com/topic/123"
}
],
"HttpStatusCode": 200,
"MaxResults": 94,
"Message": "success",
"NextToken": "下一页的token",
"RequestId": "1813ceee-7fe5-41b4-87e5-982a4d18cca5",
"Success": true,
"TotalCount": 23
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。