# 增减用户积分 / set_point
>[info] 若开启了 API 积分模式，在用户进行抽奖的时候，抽奖工坊将通过此 API 通知用户扣除积分，若抽奖失败（例如奖品不足了），则抽奖工坊会通过此 API 通知应用端返还用户积分。
>[danger] **重要！！** 当进行扣除积分操作时，请一定要判断用户剩余积分是否足够。若用户剩余积分不够时，不要进行扣除，并返回扣除失败信息。避免用户透支积分（积分被扣到负数）了还可以参与抽奖。
## **API 地址**
>[info] 此 API 由云端往您的应用端 API 地址发送请求
## **API 将传入参数**
<table>
<tr style="background:#f5f5f5;">
<th style="width:150px">参数名</th>
<th style="width:100px">类型</th>
<th style="width:100px">必须</th>
<th style="width:150px">示例</th>
<th>说明</th>
</tr>
<tr>
<td>api</td>
<td>字符串</td>
<td>是</td>
<td>set_point</td>
<td>API名称，此处固定传入 set_point</td>
</tr>
<tr>
<td>user_identifier</td>
<td>字符串</td>
<td>是</td>
<td>10001</td>
<td>用户唯一标识</td>
</tr>
<tr>
<td>change</td>
<td>整数</td>
<td>是</td>
<td>100 / -100</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：
```
{"status":"success"}
```
失败返回以下 JSON：
```
{"status":"error","msg":"积分不足"}
```
## PHP 代码片段示例
```
<?php
......
//增减积分
case 'set_point':
//获得参数
$uid = (int)$_POST['user_identifier']; //获得UID
$change = (int)$_POST['change']; //操作的分数，负数为扣除，正数为增加
//增减用户积分
$setPoint=DB('user')->where("uid",$uid)->setInc('point',$change);
//如果增减成功
if($setPoint===true){
exit({'status":"success"}');
}else{
//获取成功，返回积分信息
exit('{"status":"error","msg":"您的积分不够了"}');
}
......
?>
```
