ListHotTopics

更新时间:
复制 MD 格式

获取热点话题列表。

调试

您可以在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

http://www.example.com

Summary

string

摘要

摘要

Title

string

标题

标题

Summary

string

热榜摘要

热榜摘要

TaskErrorMessage

string

异步任务失败错误信息

异步任务失败错误信息

TaskStatus

integer

异步任务状态。0-待执行,1-执行中,2-执行成功,3-暂停(暂不使用),4-执行失败,6-任务取消(自定义事件场景下使用)

26

Topic

string

主题唯一名称

主题唯一名称

TopicSource

string

热榜源,目前支持的热榜源:

  • Toutiao:头条

  • Quark:夸克

  • Baidu:百度

  • Sina:新浪

  • Custom:自定义

  • Aggregation:热点话题榜

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

话题原文链接

https://www.example.com/topic/123

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
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。