发送第一个请求
在 BNB 测试网上查询公开卡包,无需凭据。- 打开卡包列表调试面板,选择测试网地址
https://dev-api.renaiss.xyz。 - 展开查询下的可选字段。将
stage设为active、limit设为1,然后点击发送。 - 查看响应中的
cardPacks。如果返回了卡包,可复制其slug查询卡包详情。若数组为空,表示当前没有在售卡包。
浏览接口
选择要接入的功能,按调用顺序查看步骤及对应的接口文档。卡包与抽卡
浏览卡包和内容,准备开包并查询抽卡结果。
回购
查询钱包可接受的回购报价,跟踪已提交的回购。
交易市场
查找卡牌、读取订单簿,并准备需要钱包签名的订单。
钱包收藏
查看钱包持有的卡牌、收藏估值和链上活动。
钱包访问令牌
获取登录消息、验证钱包并管理配送会话。
实物兑换与配送
查找可兑换藏品、获取运费报价、提交订单并跟踪物流。
选择环境
凭据、钱包签名和合约地址必须对应同一环境。公开目录可以直接读取。访问受保护接口时,从后端发送
x-builder-api-key 请求头。实物兑换还需要在 Authorization 请求头中提供钱包访问令牌。身份验证列出了各类操作的凭据要求。
处理响应和错误
每个接口页面列出适用的参数、请求体、响应结构和 HTTP 状态码。代币 ID 和 USDT 金额等大整数以十进制字符串返回。保留原始字符串,需要计算时再转为bigint。详见金额与标识符。
请在错误码参考中按错误码查找原因、纯文本响应及恢复方式。各接口页面也会按 HTTP 状态列出错误码。签名提交后如遇超时,先按抽卡或实物兑换指南查询状态,再决定是否重试。
字段更名、新增接口和修复记录见 API 更新日志。