搜索兑换码

搜索兑换码

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

本地契约说明

路由：GET /api/redemption/search

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

消费方：web_vue。

鉴权：Admin。需要 Admin 用户；Root 同样可以访问。

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

页面/功能：管理员兑换码页面按 ID/名称前缀及状态搜索兑换码。

前端传参：p、page_size、keyword、status。

前端展示：分页 Redemption DTO；key 不可写日志或自动复制。

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

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

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

Bodyapplication/json

示例

{
    "success": true,
    "message": "",
    "data": {
        "page": 1,
        "page_size": 20,
        "total": 1,
        "items": [
            {
                "id": 20,
                "user_id": 1,
                "key": "<redacted-redemption-code>",
                "status": 1,
                "name": "调试批次",
                "quota": 100000,
                "created_time": 1786646400,
                "redeemed_time": 0,
                "count": 0,
                "used_user_id": 0,
                "expired_time": 0
            }
        ]
    }
}

🟠401

🟠403

本地契约说明#

请求参数

请求示例代码

返回响应

本地契约说明