1.8 KiB
1.8 KiB
徽章活动相关接口
说明
-
通用返回格式, errcode=0 表示无错误
-
如无特别说明, 以下接口的Response格式指的是 data 字段
-
接口名中带*的表示, 需要验证token, token可以设置header的Authorization: Bearer JWT_token, 或Post body的token字段, 或Get的query token
{
"errcode": Number,
"errmsg": String,
"data": {}
}
1. 钱包预登录
Request
- URL:
/api/user/login
- 方法:
GET
Response
{
"nonce": String,
"tips": String
}
2. 钱包登录
客户端在获得钱包地址后,须先调用预登录方法获取nonce和tips, 然后调用钱包进行EIP-721签名.
登录成功后返回的jwt需要保存至本地存储, 再次载入后, 可解析并获取exp字段, 判断当前token是否已经过期
Request
- URL:
/api/user/login
- 方法:
POST
- 头部:
- Content-type: application/json
- Body:
{
"nonce": Number,
"signature": String,
"account": String
}
Response
{
"token": String,
}
3. *检查当前用户claim状态
Request
- URL:
/api/user/status
- 方法:
GET
- 头部:
- Authorization: Bearer JWT_token
- 参数:
uid
(用户 ID)
Response
- 类型:对象
- 属性:
account
(对象):用户账户信息。user
(对象):认证用户的信息。
4. *用户申请claim
Request
- URL:
/api/user/claim
- 方法:
POST
- 头部:
- Authorization: Bearer JWT_token
- Body: 空对象
{}
。
Response
{
"taskId": String,
}
5.* 检查claim任务的状态
Request
- URL:
/api/user/claim/:taskId
- 方法:
GET
- 头部:
- Authorization: Bearer JWT_token
Response
{
"status": Number,
"txHashList": [String],
}