URL重定向-列表
接口信息
- 接口地址:
{your-site-url}/api/skill/redirect/list
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
- 请求方式:
GET
- 说明: 此接口用于获取 URL 重定向列表，支持按类型、URL、创建时间等条件筛选和分页。
认证
请求头中需要携带 skill-access-token：
| Header |
值 |
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数 (Query String)
| 字段 |
类型 |
必填 |
说明 |
type |
int |
否 |
重定向类型。1 = 商品，2 = 商品专辑，3 = 自定义页面，4 = 博客文章，5 = 博客专辑，10 = 手动添加 |
url |
string |
否 |
对 path 和 target 字段进行 LIKE 模糊搜索，OR 条件，满足任一即可 |
created_at_begin |
string |
否 |
创建时间区间 - 开始时间，格式 YYYY-MM-DD HH:mm:ss |
created_at_end |
string |
否 |
创建时间区间 - 结束时间，格式 YYYY-MM-DD HH:mm:ss |
pageNum |
int |
否 |
页码，默认 1 |
pageSize |
int |
否 |
每页条数，默认 20 |
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/redirect/list?type=&pageNum=1&pageSize=20&url=&created_at_begin=&created_at_end=' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"list": [
{
"id": 487,
"shop_id": 15,
"path": "/blog/fecify-article-3-rg1clqpa",
"target": "/blog/fecify-article-3-m49fsg6u",
"updated_at": "2026-05-11 17:57:42",
"created_at": "2026-05-11 17:57:42",
"type": 4,
"o_id": 473
}
],
"total": 143,
"pageSize": 20,
"totalPage": 8
},
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
Number |
状态码，200 表示成功 |
message |
String |
执行结果的文字描述 |
data.list |
Array[Object] |
重定向列表 |
data.total |
int |
重定向总数 |
data.pageSize |
int |
每页条数 |
data.totalPage |
int |
总页数 |
list 子项字段
| 字段 |
类型 |
说明 |
id |
int |
重定向记录 ID |
shop_id |
int |
店铺 ID |
path |
string |
要重定向的旧路径。当用户访问此路径时，将被重定向到 target |
target |
string |
重定向的目标路径。可以是站内路径或外部 URL |
type |
int |
重定向类型。1 = 商品，2 = 商品专辑，3 = 自定义页面，4 = 博客文章，5 = 博客专辑，10 = 手动添加 |
o_id |
int |
对应的实体 ID。系统自动添加的重定向才有值（如 type=1 时为商品 ID），手动添加的重定向值为 0 |
created_at |
string |
创建时间 |
updated_at |
string |
最后更新时间 |
注意事项
url 参数对 path 和 target 同时进行模糊搜索，OR 条件，匹配任一个即返回type = 10 为手动添加的重定向，其 o_id 为 0type = 1~5 为重定向类型对应商品、商品专辑、自定义页面、博客文章、博客专辑，这类由系统自动生成，o_id 为对应实体的 ID