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>