chengkun
2025-05-26 4462855c0033970c39ac8d0da704b7dc41eabbfe
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
<?php
 
require_once(dirname(__FILE__) . '/' . 'GTBaseApi.php');
 
 
/**
 * 用户相关api,官网文档路径:http://docs.getui.com/getui/server/rest_v2/user/
 **/
class GTUserApi extends GTBaseApi
{
 
    public function __construct($gtClient){
        $this->gtClient = $gtClient;
    }
 
    //鉴权
    function auth($params)
    {
        return $this->post("/auth", $params->getApiParam());
    }
 
    //关闭鉴权,如果不传入token,则关闭该gtClient的token
    function closeAuth($params)
    {
        if($params != null){
            return $this->delete("/auth/" . $params, null);
        }else{
            return $this->delete("/auth/" . $this->gtClient->getAuthToken(), null);
        }
    }
 
    //用户绑定别名
    function bindAlias($params)
    {
        return $this->post("/user/alias", $params->getApiParam());
    }
 
    //cid查别名
    function queryAliasByCid($params)
    {
        return $this->get("/user/alias/cid/" . $params, null);
    }
 
    //别名查cid
    function queryCidByAlias($params)
    {
        return $this->get("/user/cid/alias/" . $params, null);
    }
 
    //解绑别名cid
    function unbindAlias($params)
    {
        return $this->delete("/user/alias", $params->getApiParam());
    }
 
    //解绑别名下所有cid
    function unbindAllAlias($params)
    {
        return $this->delete("/user/alias/" . $params, null);
    }
 
 
    //一个用户绑定一批标签,此操作为覆盖操作,会删除历史绑定的标签
    function setTagForCid($params)
    {
        return $this->post("/user/custom_tag/cid/" . $params->getCid(), $params->getApiParam());
    }
 
    //根据cid查询用户标签列表
    function queryUserTag($params)
    {
        return $this->get("/user/custom_tag/cid/" . $params, null);
    }
 
    //一批用户绑定一个标签
    function batchModifyTagForBatchCid($params)
    {
        return $this->put("/user/custom_tag/batch/" . $params->getCustomTag(), $params->getApiParam());
    }
 
    //解绑标签
    function unbindTag($params)
    {
        return $this->delete("/user/custom_tag/batch/" . $params->getCustomTag(), $params->getApiParam());
    }
 
    //将单个或多个用户加入黑名单,对于黑名单用户在推送过程中会被过滤掉
    //cid:用户标识,多个以英文逗号隔开,一次最多传200个
    function addBlackUser($params)
    {
        return $this->post("/user/black/cid/" . implode(",", $params), null);
    }
 
    //查询用户状态
    //cid:用户标识,多个以英文逗号隔开,一次最多传200个
    function queryUserStatus($params)
    {
        return $this->get("/user/status/" . implode(",", $params), null);
    }
 
    //将单个cid或多个cid用户移出黑名单,对于黑名单用户在推送过程中会被过滤掉的,不会给黑名单用户推送消息
    //cid:用户标识,多个以英文逗号隔开,一次最多传200个
    function removeBlackUser($params)
    {
        return $this->delete("/user/black/cid/" . implode(",", $params), null);
    }
 
    //设置角标
    function setBadge($params)
    {
        return $this->post("/user/badge/cid/" . implode(",", $params->getCids()), $params->getApiParam());
    }
 
    //通过指定查询条件来查询满足条件的用户数量
    function queryUserCount($params)
    {
        return $this->post("/user/count", $params->getApiParam());
    }
}