灵途工具箱

开放接口 / 工具导航

查询分类导航

接口概览

一次请求获取工具分类及分类下的应用,适合在网站、工作台或自建导航中展示灵途工具箱内容。文档与接口均公开访问,无需登录或 API Key。

GET/api/navigation

仅返回启用分类及已发布工具;默认保留空分类,tools 为 []。仅自营查询会隐藏没有自营工具的分类。分类按后台排序,分类内自营工具优先,自营与非自营各自保留后台顺序。

展示约定

展示工具时请保留推广标识(sponsored)以及费用与优惠条件(pricing),并使用返回的 url 作为访问地址。

请求参数

参数通过 URL 查询字符串传递。不传 owned 时,返回全部公开工具。

参数类型必填说明
ownedboolean否true:仅自营;false:仅非自营;不传:全部。仅接受小写 true / false。

筛选作用于分类中的工具;owned=true 时移除没有已发布自营工具的分类,其他查询保留空分类。所有调用方获取相同的公开工具和默认访问链接。浏览器跨域调用需在后台「跨域域名」添加主域名并启用,自动允许该域名及所有子域名;本站与服务端可直接调用,无需登录或携带 Cookie。跨域设置仅决定浏览器能否读取响应,不改变返回内容。

返回字段

成功返回 HTTP 200,JSON 顶层 data 为分类数组。

分类字段类型说明
id / slug / namestring分类 ID、标识与名称
descriptionstring分类介绍
toolsarray符合筛选条件的公开工具,无结果时为空数组
工具字段类型说明
id / slug / namestring工具 ID、标识与名称
summarystring工具简介
urlstring工具的默认访问地址
iconUrlstring | null图标地址,没有图标时为 null
ownedboolean是否为灵途自营工具
sponsoredboolean是否需展示推广标识
pricingstring费用与优惠条件说明
tagsstring[]工具用途标签
categoryobject所属分类的 slug 与 name
updatedAtstring工具更新时间,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,或不传此参数" }