SEO 服务

SEO 周边能力：友情链接集合的统一管理（列表/详情/新增/更新/删除），便于站点外链建设。当前接入友情链接线路。

/api/seo/

服务说明

SEO 服务当前提供友情链接的统一管理：列表查询、单条详情、新增、更新与删除，可用于自有站点的友链库维护，也是本站在做外链交换时使用的同一套数据。

接口为 RESTful 风格：GET / POST 作用于集合，GET / PATCH / DELETE 按数字主键 id 操作单条；链接地址全局唯一，重复提交同一 URL 会被拒绝。

本服务需项目签名。

响应格式

所有接口返回同一个 JSON 信封，业务数据都在 data 里：

{
  "code": 10000,
  "msg": "成功",
  "data": { ... }
}

code：业务状态码，10000 表示成功；其余为各类错误，完整清单见「错误码」页。
msg：给人看的提示文案，可直接展示给终端用户，但不要用它做逻辑判断。
data：业务数据；出错时通常为 null。各接口 data 的具体字段见该接口的「响应说明」。

判断成功与否请看 code，不要依赖 HTTP 状态码。查看完整错误码

友情链接

站点友情链接库（seo_friend_link）需签名

RESTful：GET/POST 作用于集合，GET/PATCH/DELETE 按数字主键 id 操作单条。

GET /api/seo/friend_links 累计调用 48747 次

友情链接列表

查询全部友情链接，支持关键词/分类/状态筛选。

关键词 keyword

选填：模糊匹配名称/链接/描述

分类 category

选填：分类精确匹配

状态过滤 status

选填：true/false

items 按 sort 降序排列；单次最多返回 500 条，超出时 truncated=true。

响应说明外层统一格式

字段	类型	说明
items	array	友情链接列表
items[].id	int	主键 ID
items[].name	string	网站名称
items[].url	string	网站链接
items[].description	string	网站描述
items[].logo	string	Logo 链接
items[].category	string	分类
items[].contact	string	联系方式
items[].sort	int	排序权重
items[].status	bool	启用状态
items[].create_time	string	创建时间
items[].updated_time	string	更新时间
total	int	命中总条数
truncated	bool	是否超过单次上限被截断

返回示例

{"items": [{"id": 1, "name": "Example", "url": "https://example.com", "description": "example site", "logo": "https://example.com/logo.png", "category": "tools", "contact": "[email protected]", "sort": 0, "status": true, "create_time": "2026-09-01 10:00:00", "updated_time": "2026-09-01 10:00:00"}], "total": 1, "truncated": false}

POST /api/seo/friend_links 累计调用 48747 次

创建友情链接

新增一条友情链接（name 必填、url 必填且全局唯一）。

网站名称 name *

必填：网站名称（可重复）

网站链接 url *

必填：完整 URL，全局唯一

网站描述 description

选填：用于 SEO 友链展示

Logo 链接 logo

选填：网站 logo 完整 URL

分类 category

选填：便于按类目筛选

联系方式 contact

选填

排序权重 sort

选填：越大越靠前，默认 0

启用状态 status

选填：默认启用

url 已存在时返回数据冲突错误。

响应说明外层统一格式

字段	类型	说明
id	int	主键 ID
name	string	网站名称
url	string	网站链接
description	string	网站描述
logo	string	Logo 链接
category	string	分类
contact	string	联系方式
sort	int	排序权重
status	bool	启用状态
create_time	string	创建时间
updated_time	string	更新时间

返回示例

{"id": 1, "name": "Example", "url": "https://example.com", "description": "example site", "logo": "https://example.com/logo.png", "category": "tools", "contact": "[email protected]", "sort": 0, "status": true, "create_time": "2026-09-01 10:00:00", "updated_time": "2026-09-01 10:00:00"}

GET /api/seo/friend_links/<id> 累计调用 4 次

获取单条

按主键 id 获取一条友情链接详情。

友情链接 ID link_id *

路径参数：友情链接主键 ID（创建/列表返回）

响应说明外层统一格式

字段	类型	说明
id	int	主键 ID
name	string	网站名称
url	string	网站链接
description	string	网站描述
logo	string	Logo 链接
category	string	分类
contact	string	联系方式
sort	int	排序权重
status	bool	启用状态
create_time	string	创建时间
updated_time	string	更新时间

返回示例

{"id": 1, "name": "Example", "url": "https://example.com", "description": "example site", "logo": "https://example.com/logo.png", "category": "tools", "contact": "[email protected]", "sort": 0, "status": true, "create_time": "2026-09-01 10:00:00", "updated_time": "2026-09-01 10:00:00"}

PATCH /api/seo/friend_links/<id> 累计调用 4 次

更新友情链接

部分字段更新：只更新本次传入的字段，未传字段保持不变。

友情链接 ID link_id *

路径参数：友情链接主键 ID（创建/列表返回）

网站名称 name

选填：新名称

网站链接 url

选填：新链接

网站描述 description

选填：用于 SEO 友链展示

Logo 链接 logo

选填：网站 logo 完整 URL

分类 category

选填：便于按类目筛选

联系方式 contact

选填

排序权重 sort

选填：越大越靠前，默认 0

启用状态 status

选填：默认启用

响应说明外层统一格式

字段	类型	说明
id	int	主键 ID
name	string	网站名称
url	string	网站链接
description	string	网站描述
logo	string	Logo 链接
category	string	分类
contact	string	联系方式
sort	int	排序权重
status	bool	启用状态
create_time	string	创建时间
updated_time	string	更新时间

返回示例

{"id": 1, "name": "Example", "url": "https://example.com", "description": "example site", "logo": "https://example.com/logo.png", "category": "tools", "contact": "[email protected]", "sort": 0, "status": true, "create_time": "2026-09-01 10:00:00", "updated_time": "2026-09-01 10:00:00"}

DELETE /api/seo/friend_links/<id> 累计调用 4 次

删除友情链接

按主键 id 删除一条友情链接。

友情链接 ID link_id *

路径参数：友情链接主键 ID（创建/列表返回）

响应说明外层统一格式

删除成功时 data 为 null，结果以 code 与 msg 判断。

接口目录 5

友情链接

GET 友情链接列表 /api/seo/friend_links POST 创建友情链接 /api/seo/friend_links GET 获取单条 /api/seo/friend_links/<id> PATCH 更新友情链接 /api/seo/friend_links/<id> DELETE 删除友情链接 /api/seo/friend_links/<id>

鉴权设置

仅本机保存

SEO 服务 API 常见问题

这个服务能做什么？

统一管理站点友情链接：列表、详情、新增、更新、删除五个端点，可作为独立友链页的数据源，也可以给多个站点共用一份友链表。

友链数据是集中存的吗？

是，存在本站数据库，多个站点读同一份数据；前台用列表端点直接渲染，不用各自维护。

前台展示要注意什么？

建议外链加 rel="nofollow noopener"，既避免被低质站点蹭权重，也避免新窗口被劫持。

SEO 服务接口怎么接入？需要签名吗？

SEO 服务挂在 /api/seo/ 前缀下：需签名的端点按 app_id + timestamp + nonce + sign（HMAC-SHA256，密钥为 APPSECRET）调用，开放端点直接请求即可。拿不准时用本页右侧的「在线调试」—— 它会代签并把你实际发出的请求与真实响应都回显出来。

SEO 服务的返回结构和错误码怎么看？

全部接口统一返回 {code, msg, data}：code=10000 表示成功，2xxxx 为业务错误，3xxxx / 4xxxx / 5xxxx 分别为外部依赖、客户端与系统错误。完整含义与处理建议见「错误码总表」（/docs/errors/）。