# 获取用户剩余抽奖次数 user/queryRemainNum
>[info] 此 API 用于获取用户在抽奖工坊中剩余的抽奖次数。
## **API 地址**
>[info] https://s1.lezhi99.com/api/user/queryRemainNum
### **API 参数列表&测试**
~~~[api]
post:https://s1.lezhi99.com/api/user/queryRemainNum
*int:project_id=10233#抽奖项目 ID
*string:identifier=23823#用户的唯一标识,例如用户 ID
*int:time=1576830778#时间戳 (Unix timestamp),精确到秒
*string:token=xxxxxxxxxx#通讯令牌 (token) 值
<<<
success
{
"status": "success",
"data": {
"remain_num": "23"
}
}
<<<
error
{
"status": "error",
"msg": "Invalid token"
}
~~~
## **返回**
此API返回内容为JSON格式,包含如下信息:
参数名 | 类型 | 必须 | 说明 |
---|---|---|---|
status | 字符串 | 是 | success=成功;error=失败/错误; |
data | 数据集 | 否 | 执行返回的数据集,当 status = success 的时候存在 |
- data.remain_num | 整数 | 是 | 用户剩余的次数 若为-1则表示获取失败(对应的用户未注册到抽奖工坊) |
msg | 字符串 | 否 | 提示信息,当 status=error 时存在。 |
获取成功返回示例:
```
{
"status": "success",
"data": {
"remain_num": "23"
}
}
```
失败返回示例:
```
{
"status": "error",
"msg": "Invalid token"
}
```