读取 Waffo Pancake Store 与可绑定产品目录

本地契约说明

路由：GET /api/option/waffo-pancake/catalog

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

消费方：web_vue。

鉴权：Root。整个 /api/option 路由组使用 RootAuth。必须为 Root Dashboard JWT 或 Root 管理 PAT；relay API Key 不可用。

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

页面/功能：Root 支付配置页加载当前或临时 Waffo Pancake 商户的 Store -> OnetimeProduct 目录，并将其作为凭证连通性探测。

前端传参：可选 merchant_id、private_key。两个参数都省略时后端使用已保存凭证；若要探测未保存凭证，必须同时发送两者。当前后端协议将临时值置于 HTTP query，因此页面不得把它们作为导航 URL、历史记录、日志或状态持久化。

前端展示：展示 stores、store 的 prodEnabled 与 active onetimeProducts；失败只显示可恢复错误，不显示或保留 merchant_id/private_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

Waffo Pancake 配置接口使用 message/data 专用响应；HTTP 200 也可能是业务失败，不能检查 success 字段。

Bodyapplication/json

示例

成功（脱敏示例）业务失败仍为 HTTP 200

{
    "message": "success",
    "data": {
        "stores": [
            {
                "id": "store_example",
                "name": "调试店铺",
                "status": "active",
                "prodEnabled": true,
                "onetimeProducts": [
                    {
                        "id": "product_example",
                        "name": "调试充值产品",
                        "status": "active"
                    }
                ]
            }
        ]
    }
}

🟠401

🟠403

读取 Waffo Pancake Store 与可绑定产品目录

本地契约说明#

请求参数

请求示例代码

返回响应

本地契约说明