篮球协会小程序接口文档


置顶新闻

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>获取置顶新闻接口</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/news/top</code></li> </ul> <h5>请求方式</h5> <ul> <li>GET </li> </ul> <h5>参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">pageNum</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Integer</td> <td>页码</td> </tr> <tr> <td style="text-align: left;">pageSize</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Integer</td> <td>每页条数</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code> {     &amp;quot;msg&amp;quot;: &amp;quot;操作成功&amp;quot;,     &amp;quot;code&amp;quot;: 200,     &amp;quot;data&amp;quot;: {         &amp;quot;total&amp;quot;: 11,         &amp;quot;hasMore&amp;quot;: true,         &amp;quot;pageSize&amp;quot;: 10,         &amp;quot;list&amp;quot;: \[             {                 &amp;quot;id&amp;quot;: 51,                 &amp;quot;title&amp;quot;: &amp;quot;沙漠绿化技术取得突破&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;生态修复&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;年绿化面积相当于上海市。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/desert\_202508190930A048.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;environment&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:30:20&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: &amp;quot;2025-08-19 16:07:31&amp;quot;             },             {                 &amp;quot;id&amp;quot;: 45,                 &amp;quot;title&amp;quot;: &amp;quot;全球首个人造子宫婴儿出生&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;医学突破&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;为早产儿治疗带来希望。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/artificial\_womb\_202508190924A039.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;medical&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:24:50&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: &amp;quot;2025-08-19 16:07:23&amp;quot;             },             {                 &amp;quot;id&amp;quot;: 42,                 &amp;quot;title&amp;quot;: &amp;quot;超级高铁试验速度破纪录&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;交通运输&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;时速达1200公里。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/hyperloop\_202508190921A034.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\\&amp;quot;/profile/upload/2025/08/19/technical\_specs\_202508190921A035.pdf\\&amp;quot;\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;transport&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:21:45&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: null             },             {                 &amp;quot;id&amp;quot;: 39,                 &amp;quot;title&amp;quot;: &amp;quot;全球粮食价格持续上涨&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;农业经济&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;气候变化影响农作物产量。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/wheat\_202508190918A030.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;agriculture&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:18:40&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: &amp;quot;2025-08-19 16:07:20&amp;quot;             },             {                 &amp;quot;id&amp;quot;: 36,                 &amp;quot;title&amp;quot;: &amp;quot;SpaceX成功发射火星飞船&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;商业航天&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;首次民间载人火星任务启动。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/spacex\_202508190915A025.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\\&amp;quot;/profile/upload/2025/08/19/mission\_plan\_202508190915A026.pdf\\&amp;quot;\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;elon&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:15:35&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: null             },             {                 &amp;quot;id&amp;quot;: 33,                 &amp;quot;title&amp;quot;: &amp;quot;南极发现未知微生物&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;极地探索&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;或改写生命起源理论。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/antarctica\_202508190912A020.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\\&amp;quot;/profile/upload/2025/08/19/science\_paper\_202508190912A021.pdf\\&amp;quot;\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;researcher&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:12:45&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: &amp;quot;2025-08-19 16:07:12&amp;quot;             },             {                 &amp;quot;id&amp;quot;: 30,                 &amp;quot;title&amp;quot;: &amp;quot;台风\\&amp;quot;海燕\\&amp;quot;即将登陆&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;天气预警&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;沿海地区启动紧急防灾预案。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/typhoon\_202508190909A015.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\\&amp;quot;/profile/upload/2025/08/19/weather\_report\_202508190909A016.pdf\\&amp;quot;\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;weather&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:09:35&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: null             },             {                 &amp;quot;id&amp;quot;: 27,                 &amp;quot;title&amp;quot;: &amp;quot;新型抗衰老药物进入临床试验&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;健康生活&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;科学家发现可延长寿命30%的化合物。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/anti\_aging\_202508190906A010.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\\&amp;quot;/profile/upload/2025/08/19/research\_paper\_202508190906A011.pdf\\&amp;quot;\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;doctor&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:06:40&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: &amp;quot;2025-08-19 16:07:06&amp;quot;             },             {                 &amp;quot;id&amp;quot;: 25,                 &amp;quot;title&amp;quot;: &amp;quot;火星探测器传回最新照片&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;太空探索&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;&amp;lt;img src=\\&amp;quot;/dev-api/profile/upload/2025/08/19/mars\_photo\_202508190904A006.png\\&amp;quot;&amp;gt;&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/mars\_thumb\_202508190904A007.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\\&amp;quot;/profile/upload/2025/08/19/nasa\_report\_202508190904A008.pdf\\&amp;quot;\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;scientist&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:04:50&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: null             },             {                 &amp;quot;id&amp;quot;: 23,                 &amp;quot;title&amp;quot;: &amp;quot;全球气候变化峰会召开&amp;quot;,                 &amp;quot;category&amp;quot;: &amp;quot;环境保护&amp;quot;,                 &amp;quot;content&amp;quot;: &amp;quot;&amp;lt;p&amp;gt;各国领导人承诺2030年前减少碳排放50%。&amp;lt;/p&amp;gt;&amp;quot;,                 &amp;quot;coverImageUrl&amp;quot;: &amp;quot;/profile/upload/2025/08/19/climate\_summit\_202508190902A003.jpg&amp;quot;,                 &amp;quot;attachmentUrls&amp;quot;: &amp;quot;\[\]&amp;quot;,                 &amp;quot;publisher&amp;quot;: &amp;quot;reporter&amp;quot;,                 &amp;quot;publishTime&amp;quot;: &amp;quot;2025-08-19 09:02:45&amp;quot;,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;isTop&amp;quot;: 1,                 &amp;quot;createTime&amp;quot;: null,                 &amp;quot;updateTime&amp;quot;: &amp;quot;2025-08-19 16:06:32&amp;quot;             }         \],         &amp;quot;pageNum&amp;quot;: 1     } }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">total</td> <td style="text-align: left;">Integer</td> <td>置顶新闻总条数</td> </tr> <tr> <td style="text-align: left;">hasMore</td> <td style="text-align: left;">Boolean</td> <td>当前页后是否还有新闻</td> </tr> <tr> <td style="text-align: left;">pageSize</td> <td style="text-align: left;">Integer</td> <td>每页新闻条数</td> </tr> <tr> <td style="text-align: left;">pageNum</td> <td style="text-align: left;">Integer</td> <td>当前页码</td> </tr> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">bigint</td> <td>新闻id</td> </tr> <tr> <td style="text-align: left;">title</td> <td style="text-align: left;">varchar</td> <td>新闻标题</td> </tr> <tr> <td style="text-align: left;">category</td> <td style="text-align: left;">varchar</td> <td>新闻种类</td> </tr> <tr> <td style="text-align: left;">content</td> <td style="text-align: left;">longtext</td> <td>新闻内容</td> </tr> <tr> <td style="text-align: left;">coverImageUrl</td> <td style="text-align: left;">varchar</td> <td>封面照片地址</td> </tr> <tr> <td style="text-align: left;">attachmentUrls</td> <td style="text-align: left;">text</td> <td>附件文件地址</td> </tr> <tr> <td style="text-align: left;">publisher</td> <td style="text-align: left;">varchar</td> <td>新闻发布人</td> </tr> <tr> <td style="text-align: left;">publishTime</td> <td style="text-align: left;">datetime</td> <td>发布时间</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">tinyint</td> <td>发布状态:发布1;未发布0</td> </tr> <tr> <td style="text-align: left;">isTop</td> <td style="text-align: left;">tinyint</td> <td>置顶状态:置顶1;未置顶0</td> </tr> <tr> <td style="text-align: left;">creatTime</td> <td style="text-align: left;">datetime</td> <td>新闻创建时间</td> </tr> <tr> <td style="text-align: left;">updateTime</td> <td style="text-align: left;">datetime</td> <td>新闻更新时间</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML