热门榜单采集

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_HotRank.md

所属接口集：热门榜单

请求 URL

POST /v1/api/hot_rank/import

认证方式

Bearer Token（详见 认证与签名）

接口概述

触发热门榜单数据采集任务，调用 import_hot_rank 管理命令从同花顺接口拉取数据并写入 hot_rank 表。

请求参数

参数	类型	必填	说明
date	string	是	采集日期，格式 YYYY-MM-DD
size	int	否	每页条数，默认 50
max_pages	int	否	最多抓取页数，默认 0（自动直到返回为空）

接口说明

• 该接口为异步触发方式，实际采集由 Django 管理命令执行
• 采集源为同花顺 data.10jqka.com.cn 接口

响应格式示例

{
  "code": 1,
  "message": "scheduled",
  "data": {
    "date": "2026-01-13",
    "size": 50,
    "max_pages": 0
  }
}

返回状态

状态码	说明
200	成功（已调度）
400	参数错误（缺少日期等）
401	未认证
403	无权限
500	执行异常

---