跳转到主要内容
POST
获取钱包登录消息
  1. 从后端提交已注册的前端 origin,同时申请 redeem:read 和 redeem:write 两项权限。
  2. 提示用户签名前,将 context 中的开发者应用 ID、签发方、受众和权限与应用配置逐项核对。
  3. 让钱包使用 personal_sign 原样签署 message。消息有效期为五分钟,仅可使用一次。将原消息和签名提交至验证钱包接口。context 仅供本地核对。

请求

需要开发者密钥

响应

错误码

在下表中查找接口返回的 HTTP 状态码和响应原文。有关各接口通用的处理建议,请参阅错误码含义与处理方式。

授权

x-builder-api-key
string
header
必填

已获准使用的开发者 API 密钥,仅在后端保存。抽卡和市场的写入操作还需钱包签名,实物兑换还需钱包签署登录消息后由 API 签发的 Bearer 令牌。

请求体

application/json
origin
string<uri>
必填

已注册的完整前端来源,包括协议、主机和端口,不含路径及末尾斜杠。

Maximum string length: 2048
示例:

"http://localhost:3100"

walletAddress
string
必填
chainId
integer
必填
scopes
enum<string>[]
必填

必须各包含一次 redeem:read 和 redeem:write,顺序不限。其他列表返回 400 API_AUTH_INVALID_INPUT。

可用选项:
redeem:read,
redeem:write

响应

成功

challengeId
string<uuid>
必填
message
string
必填
expiresAt
string<date-time>
必填
context
object
必填

用于核对登录消息;验证时不要回传该字段。