afmax导航API插件使用说明文档
一、文档概述
本文档为afmax导航API插件的使用说明，支持JSON接口调用与JS插件嵌入两种方式，可获取实用、生活、生产力工具、计算机四大分类的网站导航数据，适配电脑端与手机端展示。
二、支持分类
接口支持4类导航数据，通过id参数区分：
-
id=1：实用
-
id=2：生活
-
id=3：生产力工具
-
id=4：计算机
三、接口调用方式
1. JSON格式（直接请求API）
-
请求方式：GET
-
请求地址：
https://afmax.cn/nav_api.php -
示例地址：
https://afmax.cn/nav_api.php?id=1&num=10&type=json
2. JS插件（嵌入网页）
-
嵌入代码：
<script src="https://afmax.cn/nav_api.php?id=3&num=12&type=js"></script> -
适用场景：可嵌入任意网页，自动渲染导航列表
四、请求参数说明
| 参数 | 取值范围 | 说明 | 默认值 |
|---|---|---|---|
| id | 1/2/3/4 | 导航分类ID | 无（必传） |
| num | 1~50 | 展示网站数量 | 10 |
| type | json/js | 输出数据格式 | json |
五、JSON返回字段说明
json
{
"category": "分类名称",
"category_id": 分类ID,
"count": 返回数量,
"sites": [
{
"name": "网站名称",
"url": "网站直链",
"detail": "afmax站内介绍页链接",
"icon": "网站图标链接",
"summary": "网站简介（最多15字）"
}
]
}六、JS插件交互规则
-
点击导航卡片：直接跳转目标网站
-
点击「详细」按钮：跳转至afmax网站介绍详情页
七、展示效果
1. 电脑端
展示分类标题+网站名称+简介+详细按钮，排版规整，信息清晰。
2. 手机端
适配375px宽度移动端屏幕，响应式展示，操作便捷。
八、使用示例
示例1：获取生产力工具（id=3）12条JSON数据
请求地址：https://afmax.cn/nav_api.php?id=3&num=12&type=json
示例2：网页嵌入实用分类（id=3）12条导航
嵌入代码：<script src="https://afmax.cn/nav_api.php?id=3&num=12&type=js"></script>