搜索渠道

GET

/api/channel/search

搜索渠道

👨‍💼 需要管理员权限（Admin）

本地契约说明

路由：GET /api/channel/search

注册处理器：github.com/QuantumNous/new-api/controller.SearchChannels。

消费方：web_vue。

鉴权：Admin + channel.read。要求 Admin 身份并由服务端验证 channel.read。

字段状态：controller-confirmed-channel。字段为动态上游数据或回调负载时，文档会明确标记，不能补造 Schema。

页面/功能：渠道管理页面按 ID、名称、密钥、地址、分组或模型搜索渠道。

前端传参：keyword、group、model、状态、排序、类型和搜索分页参数。

前端展示：显示搜索结果 items、total 和 type_counts；搜索响应没有 page/page_size。

调试：使用本操作的 x-debug 里的占位符；示例不含真实密码、API Key、签名、Cookie 或 Provider 密钥。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://api-dev.opensosen.cn/api/channel/search?keyword=undefined&group=undefined&model=undefined&status=undefined&id_sort=undefined&sort_by=undefined&sort_order=undefined&tag_mode=undefined&type=undefined&p=1&page_size=20' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

application/json

管理端业务响应。HTTP 200 不代表业务成功，必须检查 success。

Bodyapplication/json

示例

{
    "success": true,
    "message": "",
    "data": {
        "items": [],
        "total": 0,
        "type_counts": {}
    }
}

🟠401

🟠403

修改于 2026-08-14 17:19:51

读取所有启用渠道的模型名

批量更新渠道状态

搜索渠道

本地契约说明#

请求参数

请求示例代码

返回响应

本地契约说明