跳转到主要内容

发送第一个请求

在 BNB 测试网上查询公开卡包,无需凭据。
  1. 打开卡包列表调试面板,选择测试网地址 https://dev-api.renaiss.xyz。
  2. 展开查询下的可选字段。将 stage 设为 active、limit 设为 1,然后点击发送。
  3. 查看响应中的 cardPacks。如果返回了卡包,可复制其 slug 查询卡包详情。若数组为空,表示当前没有在售卡包。
如果你使用 TypeScript 客户端,请参阅 SDK 快速入门。

浏览接口

选择要接入的功能,按调用顺序查看步骤及对应的接口文档。

卡包与抽卡

浏览卡包和内容,准备开包并查询抽卡结果。

回购

查询钱包可接受的回购报价,跟踪已提交的回购。

交易市场

查找卡牌、读取订单簿,并准备需要钱包签名的订单。

钱包收藏

查看钱包持有的卡牌、收藏估值和链上活动。

钱包访问令牌

获取登录消息、验证钱包并管理配送会话。

实物兑换与配送

查找可兑换藏品、获取运费报价、提交订单并跟踪物流。

选择环境

凭据、钱包签名和合约地址必须对应同一环境。公开目录可以直接读取。访问受保护接口时,从后端发送 x-builder-api-key 请求头。实物兑换还需要在 Authorization 请求头中提供钱包访问令牌。身份验证列出了各类操作的凭据要求。

处理响应和错误

每个接口页面列出适用的参数、请求体、响应结构和 HTTP 状态码。代币 ID 和 USDT 金额等大整数以十进制字符串返回。保留原始字符串,需要计算时再转为 bigint。详见金额与标识符。 请在错误码参考中按错误码查找原因、纯文本响应及恢复方式。各接口页面也会按 HTTP 状态列出错误码。签名提交后如遇超时,先按抽卡或实物兑换指南查询状态,再决定是否重试。 字段更名、新增接口和修复记录见 API 更新日志。