> For the complete documentation index, see [llms.txt](https://api-doc.8i5.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-doc.8i5.net/ai-pai-xing-bang/shi-yong-fang-fa.md).

# 使用方法

#### 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 正常返回示例

```json
{
    "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 异常返回示例（如请求失败）

```json
{
    "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调用示例

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

#### 6.2 JavaScript调用示例（Fetch）

```javascript
// 前端跨域调用示例
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）

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