SuperAPI AI 工具集

snapscan

办公与效率

查看项目

更新于 10-16 00:28

技能介绍

SnapScan 是南非流行的移动支付应用,用户扫描二维码即可付款,商户无需传统 POS 系统即可收款。官方文档见 https://developers.snapscan.io/。涉及对象包括 Payment、Payment Request、Merchant、Voucher、Loyalty card、Donation、Withdrawal、Account、Transaction 等。

本技能通过 Membrane CLI 与 SnapScan 交互,Membrane 自动处理认证和凭证刷新。安装:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无界面环境会打印授权 URL,完成后执行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。

建立连接:membrane connection ensure "https://www.snapscan.co.za/" --json,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY;若为 CLIENT_ACTION_REQUIRED,按 clientAction 提示操作。

查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。执行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,可传 --input '{"key": "value"}'。

当已有动作不足时,可通过代理直接请求 SnapScan API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。

建议优先使用 Membrane 预置动作而非自行编写 API 调用,不要向用户索取 API 密钥,而是创建连接由服务端管理认证。具体可用动作、参数细节及限额等信息资料未完全提供。