SEO Service

SEO-related capabilities: unified management of the Friend links collection (list/detail/create/update/delete) to facilitate Site Backlink building. Currently connected to the Friend links Channel.

/api/seo/

Service Description

The SEO service currently manages friend links: list, single-item detail, create, update and delete. It works for maintaining a link-exchange library and is the same data set this site uses when exchanging links.

The API is RESTful: GET / POST act on the collection, while GET / PATCH / DELETE operate on a single record by numeric id. Link URLs are globally unique, so submitting the same URL twice is rejected.

This service requires project signature authentication.

Response Format

Every endpoint returns the same JSON envelope; the payload is always inside data:

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

code: business status code. 10000 means success; anything else is an error — see the Error Codes page for the full list.
msg: a human-readable message you can show to end users, but never use it for program logic.
data: the payload; usually null on error. Each endpoint's Response section lists its data fields.

Judge success by code, not by the HTTP status code. View all error codes

Friend Links

Site friend links library (seo_friend_link) Signature Required

RESTful: GET/POST operate on the collection, while GET/PATCH/DELETE operate on a single item by numeric primary key id.

GET /api/seo/friend_links Total calls: 0

Friend Link List

Query all friend links, with keyword/category/status filtering.

Keyword keyword

Optional: fuzzy match on name/URL/description

Category category

Optional: exact category match

Status filter status

Optional: true/false

items is sorted by sort descending; at most 500 records are returned per request, with truncated=true when exceeded.

Response Common envelope

Field	Type	Description
items	array	Friend Link List
items[].id	int	Primary key ID
items[].name	string	Site name
items[].url	string	Site URL
items[].description	string	Site description
items[].logo	string	Logo URL
items[].category	string	Category
items[].contact	string	Contact
items[].sort	int	Sort weight
items[].status	bool	Status
items[].create_time	string	Created
items[].updated_time	string	Updated time
total	int	Total matched count
truncated	bool	Whether truncated by the per-request limit

Example response

{"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 Total calls: 0

Create Friend Link

Create a friend link (name is Required, url is Required and globally unique).

Site name name *

Required: Site name (duplicates allowed)

Site URL url *

Required: full URL, globally unique

Site description description

Optional: used for SEO friend links display

Logo URL logo

Optional: full URL of the site logo

Category category

Optional: useful for filtering by category

Contact contact

Optional

Sort weight sort

Optional: the larger the value, the higher the ranking; Default 0

Status status

Optional: enabled by default

Returns a data conflict error when the url already exists.

Response Common envelope

Field	Type	Description
id	int	Primary key ID
name	string	Site name
url	string	Site URL
description	string	Site description
logo	string	Logo URL
category	string	Category
contact	string	Contact
sort	int	Sort weight
status	bool	Status
create_time	string	Created
updated_time	string	Updated time

Example response

{"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> Total calls: 0

Get One

Get the details of a friend link by primary key id.

Friend link ID link_id *

Path parameter: friend link primary key ID (returned by create/list)

Response Common envelope

Field	Type	Description
id	int	Primary key ID
name	string	Site name
url	string	Site URL
description	string	Site description
logo	string	Logo URL
category	string	Category
contact	string	Contact
sort	int	Sort weight
status	bool	Status
create_time	string	Created
updated_time	string	Updated time

Example response

{"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> Total calls: 0

Update Friend Link

Partial update: only the fields provided in this request are updated; unprovided fields remain unchanged.

Friend link ID link_id *

Path parameter: friend link primary key ID (returned by create/list)

Site name name

Optional: new name

Site URL url

Optional: new URL

Site description description

Optional: used for SEO friend links display

Logo URL logo

Optional: full URL of the site logo

Category category

Optional: useful for filtering by category

Contact contact

Optional

Sort weight sort

Optional: the larger the value, the higher the ranking; Default 0

Status status

Optional: enabled by default

Response Common envelope

Field	Type	Description
id	int	Primary key ID
name	string	Site name
url	string	Site URL
description	string	Site description
logo	string	Logo URL
category	string	Category
contact	string	Contact
sort	int	Sort weight
status	bool	Status
create_time	string	Created
updated_time	string	Updated time

Example response

{"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> Total calls: 0

Delete Friend Link

Delete a friend link by primary key id.

Friend link ID link_id *

Path parameter: friend link primary key ID (returned by create/list)

Response Common envelope

On successful deletion data is null; judge the result from code and msg.

Endpoint catalog 5

Friend Links

GET Friend Link List /api/seo/friend_links POST Create Friend Link /api/seo/friend_links GET Get One /api/seo/friend_links/<id> PATCH Update Friend Link /api/seo/friend_links/<id> DELETE Delete Friend Link /api/seo/friend_links/<id>

Auth Settings

Stored locally only