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 累計調用 0 次

友情鏈接列表

查詢全部友情鏈接，支持關鍵詞/分類/狀態篩選。

關鍵詞 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": "admin@example.com", "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 累計調用 0 次

創建友情鏈接

新增一條友情鏈接（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": "admin@example.com", "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> 累計調用 0 次

獲取單條

按主鍵 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": "admin@example.com", "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> 累計調用 0 次

更新友情鏈接

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

友情鏈接 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": "admin@example.com", "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> 累計調用 0 次

刪除友情鏈接

按主鍵 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>

鑑權設置

僅本機保存