瑞科验证网关控制台

本机调试工具 · 接口签名、联调与响应排查

网关地址 未填写网关地址 未配置

Gateway

网关配置

填写 Worker 根地址与客户端凭据。接口路径会自动拼接 /v1。

本机保存 修改后自动保存

只填 Worker 根地址，例如 https://rk-verify-gateway.xxx.workers.dev

密钥只存在本机浏览器，不会上传到服务器

相当于「客户端上报的设备标识」。留空会自动向网关领取一个；但只有填成卡密已绑定的那个，登录才会成功，填错会返回 1013 或触发换绑扣时。

连接测试调用 GET /v1/health，无需签名。
密钥只存在本机浏览器，不会上传到服务器。 配置以明文保存在 localStorage，请勿在公用电脑使用；请求日志仅保存在当前页面内存中。

Session

登录 / 当前会话

登录成功后自动记住 token、heartbeatkey、到期时间与剩余点数，供后续接口复用。

会话仅保存在当前页面内存

当前会话

未登录
尚未建立会话。完成卡密登录或账号登录后，这里会显示脱敏后的 token、heartbeatkey、到期时间与剩余点数。

Card & Account

卡密与账号

查询详情、解绑机器码、修改备注。多数接口会自动使用顶部配置中的 maccode。

卡密详情

POST /v1/card/detail

账号详情

POST /v1/account/detail

机器码解绑

POST /v1/machine/unbind

修改卡密备注

POST /v1/remark
会话 token

Point & Remote

点数与远程能力

以下接口需要当前会话 token，卡密 / 账号会自动取自登录结果。

扣点

POST /v1/point
会话 token

获取远程变量

POST /v1/remote/var
会话 token

获取远程算法

POST /v1/remote/algo
会话 token

Recharge & Account

充值与账号管理

充值卡充值、注册、修改密码。账号与密码字段会原样交给网关。

充值

POST /v1/recharge

充值卡详情

POST /v1/recharge/detail

账号注册

POST /v1/account/register

修改账号密码

POST /v1/account/password

Payment & Order

支付与订单

价格类型 ID 原样传递；扫码支付接口会返回二维码相关数据，请在响应日志中查看。

扫码购买

POST /v1/pay/qr-buy

卡密扫码续费

POST /v1/pay/qr-renew-card

账号扫码续费

POST /v1/pay/qr-renew-account

订单查询

POST /v1/order/query

Init

初始化

版本名用于获取版本更新信息，按实际软件版本填写。

初始化

POST /v1/init

Raw Call

通用调用

直接调用 POST /v1/call。biz 为瑞科业务编号 1~21，args 必须是 JSON 对象。

POST /v1/call
通用调用不会自动附加 maccode / token，请按 biz 需要自行写入 args。
签名与接入说明 四个认证请求头、body 哈希与 HMAC-SHA256 拼接方式，供其他语言接入时对照。 展开

1. 四个认证请求头

x-rk-id 客户端 ID。
x-rk-ts 毫秒时间戳，String(Date.now())。
x-rk-nonce 16 字节随机数的小写十六进制，共 32 位。
x-rk-sign 小写十六进制 HMAC-SHA256 签名，共 64 位。

除 GET /v1/health 外，所有接口都是 POST，请求体为 JSON 对象，Content-Type: application/json。四个头全部参与校验，缺一不可。

2. 签名计算

bodyHash = lowerHex(SHA-256(rawBodyText))
signingText = id + "\n" + ts + "\n" + nonce + "\n" + bodyHash
sign = lowerHex(HMAC-SHA256(secret, signingText))

rawBodyText 就是最终发送的请求体文本。本页只执行一次 JSON.stringify(obj)，同一份字符串既用于计算哈希，也原样作为 fetch 的 body，避免重新序列化造成空格或键序差异。

响应统一为 { ok, code, msg, data, ms }，code === 0 表示业务成功；负数多为本地 / 网关错误，正数为瑞科服务端错误码。

浏览器直连需要 CORS。 如果点击连接测试时出现 Failed to fetch，通常不是地址写错，而是 Worker 未放行跨域请求。Worker 需要返回 Access-Control-Allow-Origin（Pages 域名或 *）、 Access-Control-Allow-Headers: content-type, x-rk-id, x-rk-ts, x-rk-nonce, x-rk-sign、 Access-Control-Allow-Methods: GET, POST, OPTIONS，并正确响应浏览器的 OPTIONS 预检。本页面无法绕过浏览器同源策略。