# 查询用户积分 / query_point
>[info] 若开启了 API 积分模式,那么当用户进入活动页面的时候,需要在页面上显示用户的当前积分。抽奖工坊即用此 API 查询用户的剩余积分。
## **API 地址**
>[info] 此 API 由云端往您的应用端 API 地址发送请求
## **API 将传入参数**
<table>
<tr style="background:#f5f5f5;">
<th style="width:150px">参数名</th>
<th style="width:150px">类型</th>
<th style="width:100px">必须</th>
<th style="width:150px">示例</th>
<th>说明</th>
</tr>
<tr>
<td>api</td>
<td>字符串</td>
<td>是</td>
<td>query_point</td>
<td>API名称,此处固定传入 query_point</td>
</tr>
<tr>
<td>user_identifier</td>
<td>字符串</td>
<td>是</td>
<td>10001</td>
<td>用户唯一标识</td>
</tr>
<tr>
<td>time</td>
<td>整数</td>
<td>是</td>
<td>1576830778</td>
<td>时间戳 (Unix timestamp),精确到秒</td>
</tr>
<tr>
<td>token</td>
<td>字符串</td>
<td>是</td>
<td>xxxxxxxxxx</td>
<td>访问令牌 token</td>
</tr>
</table>
## **返回**
通讯成功请返回以下 JSON ,其中 point 指用户剩余积分数额。
```
{"status":"success","point":2000}
```
失败返回以下 JSON:
```
{"status":"error","msg":"这里写失败说明"}
```
## PHP 代码片段示例
```
<?php
......
//查询积分
case 'query_point':
//获得UID
$uid = (int)$_POST['user_identifier'];
//获得用户积分
$point= DB("user")->where("uid",$uid)->getValue("point");
//获取成功,返回积分信息
if($point!==false){
exit({'status":"success","point":'.$point.'}');
}else{
//如果获取失败,返回错误信息
exit('{"status":"error","msg":"不存在此用户"}');
}
......
?>
```