📦 统一响应格式
成功响应
{
"success": true,
"data": [...],
"total": 100,
"page": 1,
"pageSize": 20
}错误响应
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "资源不存在"
}
}🔌 API 端点
GET
/api/v1/search搜索工具(关键词 + 筛选)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 必填 | 搜索关键词 |
category | string | 可选 | 分类 slug 筛选 |
pricing | string | 可选 | free | freemium | paid |
lang | string | 可选 | zh | en | both |
limit | number | 可选 | 每页数量(默认 20,最大 100) |
page | number | 可选 | 页码(默认 1) |
GET
/api/v1/categories获取所有分类
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tree | boolean | 可选 | 是否返回树形结构(默认 false) |
GET
/api/v1/categories/:slug获取分类详情(含子分类)
GET
/api/v1/categories/:slug/sites获取分类下的工具列表
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sort | string | 可选 | hot | latest | featured |
pricing | string | 可选 | free | freemium | paid |
lang | string | 可选 | zh | en | both |
limit | number | 可选 | 每页数量 |
page | number | 可选 | 页码 |
GET
/api/v1/sites获取工具列表(支持筛选)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 可选 | 搜索关键词 |
category | string | 可选 | 分类 slug |
pricing | string | 可选 | free | freemium | paid |
lang | string | 可选 | zh | en | both |
limit | number | 可选 | 每页数量 |
page | number | 可选 | 页码 |
GET
/api/v1/sites/featured获取精选工具
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 可选 | 数量(默认 8,最大 50) |
GET
/api/v1/sites/latest获取最新收录工具
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 可选 | 数量(默认 8,最大 50) |
GET
/api/v1/sites/:slug获取工具详情
GET
/api/v1/tags获取所有标签
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | 可选 | chain | feature | pricing | language |
POST
/api/v1/sites/submit提交新工具收录
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 必填 | 工具名称 |
url | string | 必填 | 工具 URL |
categoryId | number | 可选 | 分类 ID |
description | string | 可选 | 工具描述 |
logo | string | 可选 | Logo URL |
submittedByEmail | string | 可选 | 提交者邮箱 |
POST
/api/v1/agents/registerAgent 注册(获取 API Key)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 必填 | Agent 名称 |
description | string | 可选 | Agent 描述 |
homepage | string | 可选 | Agent 主页 URL |
💡 使用示例
搜索免费 DeFi 工具
GET /api/v1/search?q=defi&pricing=free
浏览交易所分类
GET /api/v1/categories/cex/sites?sort=hot
获取精选工具
GET /api/v1/sites/featured?limit=5
获取工具详情
GET /api/v1/sites/uniswap
⚡ 速率限制
- • 通用端点:60 次请求 / 分钟 / IP
- • 搜索端点:30 次请求 / 分钟 / IP
- • 所有 API 支持 CORS,可从任何域名调用