开放接口 / 工具导航
查询分类导航
接口概览
一次请求获取工具分类及分类下的应用,适合在网站、工作台或自建导航中展示灵途工具箱内容。文档与接口均公开访问,无需登录或 API Key。
GET
/api/navigation仅返回启用分类及已发布工具;默认保留空分类,tools 为 []。仅自营查询会隐藏没有自营工具的分类。分类按后台排序,分类内自营工具优先,自营与非自营各自保留后台顺序。
展示约定
展示工具时请保留推广标识(sponsored)以及费用与优惠条件(pricing),并使用返回的 url 作为访问地址。
请求参数
参数通过 URL 查询字符串传递。不传 owned 时,返回全部公开工具。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
owned | boolean | 否 | true:仅自营;false:仅非自营;不传:全部。仅接受小写 true / false。 |
筛选作用于分类中的工具;owned=true 时移除没有已发布自营工具的分类,其他查询保留空分类。所有调用方获取相同的公开工具和默认访问链接。浏览器跨域调用需在后台「跨域域名」添加主域名并启用,自动允许该域名及所有子域名;本站与服务端可直接调用,无需登录或携带 Cookie。跨域设置仅决定浏览器能否读取响应,不改变返回内容。
返回字段
成功返回 HTTP 200,JSON 顶层 data 为分类数组。
| 分类字段 | 类型 | 说明 |
|---|---|---|
id / slug / name | string | 分类 ID、标识与名称 |
description | string | 分类介绍 |
tools | array | 符合筛选条件的公开工具,无结果时为空数组 |
| 工具字段 | 类型 | 说明 |
|---|---|---|
id / slug / name | string | 工具 ID、标识与名称 |
summary | string | 工具简介 |
url | string | 工具的默认访问地址 |
iconUrl | string | null | 图标地址,没有图标时为 null |
owned | boolean | 是否为灵途自营工具 |
sponsored | boolean | 是否需展示推广标识 |
pricing | string | 费用与优惠条件说明 |
tags | string[] | 工具用途标签 |
category | object | 所属分类的 slug 与 name |
updatedAt | string | 工具更新时间,ISO 8601 格式 |
以下为结构示例,实际内容以接口实时返回为准。
JSON · 200
{
"data": [
{
"id": "category-example",
"slug": "example-category",
"name": "示例分类",
"description": "分类介绍",
"tools": [
{
"id": "tool-example",
"slug": "example-tool",
"name": "示例工具",
"summary": "工具用途说明",
"pricing": "费用与优惠条件以工具页面为准",
"url": "https://example.com/",
"iconUrl": null,
"tags": [
"示例标签"
],
"sponsored": false,
"category": {
"slug": "example-category",
"name": "示例分类"
},
"owned": true,
"updatedAt": "2026-11-12T00:00:00.000Z"
}
]
}
]
}调用示例
下面示例只查询自营工具。查询非自营工具时改为 owned=false,查询全部时移除该参数。
cURL
curl 'https://link2.cn/api/navigation?owned=true'JavaScript · 服务端
const response = await fetch(
'https://link2.cn/api/navigation?owned=true'
);
if (!response.ok) throw new Error('导航查询失败');
const { data } = await response.json();
for (const category of data) {
console.log(category.name, category.tools);
}在线调试
直接请求本站公开接口,查看筛选后的真实响应。
全部工具(不传)
仅自营(true)
仅非自营(false)
GET /api/navigation选择参数并发送请求,查看当前导航数据。
错误处理
| 状态码 | 说明 | 处理方式 |
|---|---|---|
400 | 参数无效 | 检查 owned 是否为 true / false,且仅传一次。 |
403 | 跨域预检未获允许 | 在后台「跨域域名」添加并启用调用网站域名;普通 GET 未获允许时不返回跨域许可头,浏览器会阻止读取。 |
503 | 服务暂不可用 | 稍后重试。 |
JSON · 400
{ "error": "owned 必须为 true 或 false,或不传此参数" }