📝使用方法

1. 1接口地址

https://api.8i5.net/hot/v2/pc-online.php

1.2 接口描述

该接口用于获取AI软件热度排行榜数据，返回数据包含软件排名、名称、LOGO、简介、热度值、所属公司、适用场景等核心信息，数据实时更新，可直接用于应用开发、数据展示等场景。

1.3 请求方式

GET

2. 请求参数

该接口无需传入额外请求参数，直接发起GET请求即可返回完整排行榜数据。

3. 返回数据说明

3.1 数据格式

返回格式为JSON，编码为UTF-8，数据结构分为根节点和数据列表节点两层，字段命名规范、易解析。

3.2 根节点参数说明

参数名	类型	是否必返	说明
date	string	是	接口响应时间，格式：YYYY-MM-DD HH:MM:SS
platform	string	是	接口标识，固定值：8i5.net
category	string	是	数据分类，固定值：AI软件排行榜
api_time	string	否	数据更新时间（与排行榜数据同步更新）
data	array	是	AI软件排行榜数据列表（错误时为错误对象）

3.3 data列表项参数说明（正常返回时）

参数名	类型	是否必返	说明
id	string	是	软件唯一标识ID
rank	int	是	软件当前热度排名（数值越小排名越靠前）
name	string	是	软件名称
logo	string	是	软件LOGO图片URL（可直接用于前端展示）
short_desc	string	是	软件简短介绍（100字以内，便于快速了解）
description	string	是	软件详细描述（包含核心功能、特点等）
scene_list	array	是	软件适用场景标签列表（如：文字办公、图像处理等）
hot_degree	float	是	软件热度值（数值越高表示热度越高）
growth_rate	float	是	热度增长率（负数=热度下降，正数=热度上升）
company	string	是	软件所属公司/开发团队名称
last_rank	int	是	上一期排名（用于对比排名变化）
highlight	boolean	是	是否为推荐软件（true=推荐，false=普通）

3.4 data错误对象参数说明（异常返回时）

参数名	类型	是否必返	说明
error	string	是	错误详细描述信息（便于问题排查）

4. 返回示例

4.1 正常返回示例

{
    "date": "2025-12-21 23:50:00",
    "platform": "8i5.net",
    "category": "AI软件排行榜",
    "api_time": "2025-12-21 22:56:19",
    "data": [
        {
            "id": "1",
            "rank": 1,
            "name": "豆包",
            "logo": "https://img.pconline.com.cn/images/upload/upc/tx/pcncc/2510/22/c1/564707057_1761128523274.png",
            "short_desc": "一款专业性强的智能助手，能在知识问答、内容创作等多个方面为用户提供帮助。",
            "description": "豆包是字节跳动推出的AI智能助手，集成了大模型技术，提供语音交互、信息查询、旅游出行、英语学习及情感交流等服务。豆包还推出了面向开发者的工具豆包MarsCode，提升编程效率。",
            "scene_list": [
                "文字办公",
                "图像处理",
                "学习教育",
                "聊天机器人",
                "文字写作",
                "效率提升",
                "创意生图",
                "一键抠图",
                "图片扩展",
                "角色扮演"
            ],
            "hot_degree": 14475.00,
            "growth_rate": -0.0066,
            "company": "字节跳动",
            "last_rank": 1,
            "highlight": false
        },
        {
            "id": "74",
            "rank": 2,
            "name": "DeepSeek",
            "logo": "https://img.pconline.com.cn/images/upload/upc/tx/pcncc/2506/27/c2/530621860_1751012031786.png",
            "short_desc": "一款功能强大的聊天AI助手，能够提供智能对话服务。",
            "description": "DeepSeek 是一款强大的聊天 AI 助手，能够提供智能对话服务。它具有自然语言理解和生成的能力，能够回答问题、提供建议和进行闲聊。DeepSeek 的主要功能包括语义分析、情感识别、知识图谱等。无论是提供技术支持，还是陪伴聊天，DeepSeek 都能为用户提供个性化的服务。",
            "scene_list": [
                "文字办公",
                "文字写作",
                "效率提升"
            ],
            "hot_degree": 13906.00,
            "growth_rate": -0.0043,
            "company": "深度求索",
            "last_rank": 2,
            "highlight": false
        }
    ]
}

4.2 异常返回示例（如请求失败）

{
    "date": "2025-12-21 23:55:00",
    "platform": "8i5.net",
    "category": "AI软件排行榜",
    "api_time": "",
    "data": {
        "error": "接口访问失败，请检查网络连接或稍后重试"
    }
}

5. 错误码说明

错误描述	可能原因	解决方案
接口访问失败，请检查网络连接或稍后重试	服务器网络异常/接口暂时不可用	检查网络状态，1-5分钟后重试
HTTP请求失败，状态码: 403	请求头不合法/访问权限限制	使用标准浏览器请求头，避免频繁请求
JSON解析失败: Syntax error	数据传输过程中出现异常	重新发起请求，若多次失败联系接口维护人员
未抓取到排行榜数据，接口返回数据为空	数据更新中/暂无有效排行数据	稍后重试，一般数据更新周期不超过10分钟
HTTP请求失败，状态码: 500	服务器内部处理异常	记录请求时间和场景，联系接口维护人员

6. 调用示例

6.1 curl调用示例

curl -X GET "https://api.8i5.net/hot/v2/pc-online.php"

6.2 JavaScript调用示例（Fetch）

// 前端跨域调用示例
fetch('https://api.8i5.net/hot/v2/pc-online.php')
  .then(response => {
    if (!response.ok) throw new Error('请求失败');
    return response.json();
  })
  .then(data => {
    console.log('AI软件排行榜数据：', data);
    // 后续处理：渲染页面、数据筛选等
  })
  .catch(error => {
    console.error('接口调用失败：', error.message);
  });

6.3 Python调用示例（requests）

import requests

api_url = 'https://api.8i5.net/hot/v2/pc-online.php'
try:
    # 发起GET请求
    response = requests.get(api_url, timeout=30)
    response.raise_for_status()  # 抛出HTTP错误
    result = response.json()
    
    # 打印结果
    print(f"接口响应时间：{result['date']}")
    print(f"排行榜数据总数：{len(result['data'])}")
    for item in result['data'][:5]:  # 打印前5条数据
        print(f"排名{item['rank']}：{item['name']}（热度：{item['hot_degree']}）")
except requests.exceptions.RequestException as e:
    print(f"调用失败：{str(e)}")

7. 注意事项

1. 接口请求频率限制：建议控制在1次/分钟以内，避免频繁请求影响服务稳定性；

2. 数据使用规范：返回的软件LOGO、描述等信息仅可用于非商业场景展示，请勿擅自用于商业用途或篡改数据；

3. 缓存建议：生产环境使用时，建议增加本地缓存机制（如Redis缓存5-10分钟），减少接口调用次数，提升响应速度；

4. 兼容性处理：部分字段（如api_time）可能为空，建议前端调用时增加字段判空处理，避免渲染异常；

5. 问题反馈：若长期出现调用失败或数据异常，可记录请求时间、错误信息等，联系接口提供方进行排查。