API 文档 - NexusTools

API 概述

NexusTools 提供 RESTful API 接口，允许第三方应用访问工具数据。所有 API 请求需要通过 API 密钥进行认证。

Base URL:


                    https://demo.leleweb.cn/api/v1

认证方式

在请求头中添加 X-API-Key 或在 URL 参数中添加 api_key

# Header 方式（推荐）
curl -H "X-API-Key: your_api_key" \
     https://demo.leleweb.cn/api/v1/tools

# Query 参数方式
curl "https://demo.leleweb.cn/api/v1/tools?api_key=your_api_key"
            

工具接口

GET /tools

获取工具列表，支持分页和分类筛选

参数	类型	说明
page	int	页码，默认 1
limit	int	每页数量，默认 20，最大 100
category_id	int	分类ID，筛选指定分类

{
  "success": true,
  "data": {
    "data": [
      { "id": 1, "name": "JSON格式化", "slug": "json-formatter", ... }
    ],
    "pagination": { "page": 1, "limit": 20, "total": 96, "total_pages": 5 }
  }
}
                

GET /tools/{slug}

获取单个工具详情

参数	类型	说明
slug *	string	工具别名或ID

GET /tools/search

搜索工具（此接口不强制要求认证）

参数	类型	说明
q *	string	搜索关键词
limit	int	返回数量，默认 20，最大 50

分类接口

GET /categories

获取所有分类列表

GET /categories/{id}

获取分类详情及其下的工具列表

统计接口

GET /stats

获取网站统计数据，包括工具数、分类数、访问量、热门工具等

错误码

状态码	说明
200	请求成功
400	请求参数错误
401	未认证或密钥无效
403	没有访问权限
404	资源不存在
429	请求频率超限
500	服务器内部错误

{
  "success": false,
  "error": {
    "code": 401,
    "message": "无效的API密钥"
  }
}
            

频率限制

每个 API 密钥都有独立的频率限制（默认 1000 次/小时）。超出限制后将返回 429 错误，请合理控制请求频率。