Skip to main content
POST
查询指定品牌下的 AI 对话问题(监控提示词)列表。支持按主题、监控状态、关键词筛选。接口固定返回全量列表,按创建时间倒序排列。
执行模式:SYNC · 实时请求。 请求发出后服务端同步执行业务,结果直接在当前响应的 data 中返回,不存在异步任务、无需轮询、无需二次查询。

接口速查

请求头

string
required
开发者 API Key,例如 AIBase_xxx。用于身份认证、有效期与调用权限校验,请仅在服务端保存和使用。
string
required
固定为 application/json。
string
开发者自定义请求 ID,用于请求追踪;不传时系统自动生成 UUID。

请求体

string
required
固定为 brand.prompt
string
required
所属品牌 ID,为空返回 4001
string
按主题筛选;不传返回品牌下全部问题
integer
1 监控中,0 未监控;不传不筛选
string
按AI对话问题关键词模糊筛选

返回参数

业务结果位于 data,为分页结构,其中 records 为 AI 对话问题列表(本接口固定返回全量,size = -1)。
object[]
AI 对话问题明细列表。
string
问题唯一标识(即 promptId)。
string
所属主题名称。
string
AI 对话问题文本。
string
格式 yyyy-MM-dd HH:mm:ss。
integer
1 监控中,0 未监控。
string
最近一次查询日期,可能为 null。
long / integer
总数、每页条数、当前页、总页数;本接口返回全量,size = -1。
long / integer
同上,见上方分页字段说明。
long / integer
同上,见上方分页字段说明。
long / integer
同上,见上方分页字段说明。

接入注意事项

  1. apiCode 必须固定为 brand.prompt。
  2. brandId 为必填参数,为空返回 4001(所需参数不足)。
  3. topicId、monitorType、keyword 均为可选筛选条件。
  4. 接口固定返回全量列表,size = -1,无需传分页参数。
  5. queryDate 为最近查询日期,可能为 null。
  6. 问题 ID(id)可继续用于 prompt.analysis.detail 接口的 promptId 筛选。
完整响应类型可表示为 ReturnResult<PageResult<PromptData>>(PageResult 定义见 6.2.5)。
可按以下 TypeScript 类型定义解析响应数据。
本页的 cURL 与 Java 示例来自官方接口文档;Python 与 Node.js 示例为等价转写,未经服务端联调,请以实际返回结果为准。