[中文]

用途:

• 获取指定话题下的笔记列表，支持按最热或最新排序，使用游标分页

⚠️ 计费提示:

• 如果传入错误或不存在的话题页面ID，接口仍会正常响应，但 data 中会返回上游"服务异常"信息，该请求 同样会正常计费扣费，请在调用前确保参数有效。

参数:

• page_id: 话题页面ID（必需），如 "5c1cc866febed9000184b7c1"
  • 可以从单一笔记接口获取或搜索接口
• sort: 排序方式
  • "trend": 最热（默认）
  • "time": 最新
• cursor_score: 分页游标分数，翻页时传入上一页最后一个 item 的 cursor_score
• last_note_id: 上一页最后一条笔记ID，翻页时传入
• last_note_ct: 上一页最后一条笔记创建时间，翻页时传入
• session_id: 会话ID，翻页时保持一致
• first_load_time: 首次加载时间戳，翻页时保持一致
• source: 来源，默认 "normal"

返回:

• 话题笔记列表数据

翻页说明:

• 首次请求：只传 page_id 和 sort，其余留空
• 翻页请求：取上一次响应最后一个 item 的字段:
  • cursor_score ← items[-1].cursor_score
  • last_note_id ← items[-1].id
  • last_note_ct ← items[-1].create_time
• 建议同时回传 session_id 和 first_load_time 保持会话一致

[English]

Purpose:

• Get notes list under a specified topic, supports sorting by trending or latest, using cursor pagination

⚠️ Billing Notice:

• If a wrong or non-existent topic page ID is passed, the endpoint still responds normally, but the data field will contain an upstream "service error" message. Such requests will still be billed as normal. Please make sure the parameters are valid before calling.

Parameters:

• page_id: Topic page ID (required), e.g. "5c1cc866febed9000184b7c1"
  • Can be obtained from single note API or search API
• sort: Sort type
  • "trend": Trending (default)
  • "time": Latest
• cursor_score: Pagination cursor score, pass last item's cursor_score from previous response
• last_note_id: Last note ID from previous page
• last_note_ct: Last note create time from previous page
• session_id: Session ID, keep consistent for pagination
• first_load_time: First load timestamp, keep consistent for pagination
• source: Source, default "normal"

Return:

• Topic notes list data

Pagination Guide:

• First request: only pass page_id and sort, leave others empty
• Next page: pass fields from last item of previous response:
  • cursor_score ← items[-1].cursor_score
  • last_note_id ← items[-1].id
  • last_note_ct ← items[-1].create_time
• Recommended to also pass session_id and first_load_time for session consistency

[示例/Example]

page_id="5c1cc866febed9000184b7c1" sort="trend"