# 数据服务API

# 设备关联用户信息 API

开始使用前，请先创建应用，key和secret

# 请求

GET https://aecore.glodon.com/ops/oauth/data/device/user/{id}

参数名	必选	类型	描述
Authorization	是	String	Bearer access_token
Content-Type	是	String	application/json

# 路径参数

参数名	必选	类型	描述
id	是	String	设备ID

# body 参数

参数名	必选	类型	描述
id	是	String	设备ID
product	是	String	中台产品标识，必填，可以是 pid, spid, appname, pcode中的任意一个，系统会将其映射为中台唯一的产品ID，返回的用户是该设备上使用了该产品的全部用户列表

# 响应

HTTP 代码	说明	类型
200	ok	请求成功，根据业务 code 解析实际结果

#

# 成功返回结果

{"code":200, 
"message":"success",
"data": {
    "totalPage": 1, //总页数
    "totalElement": 100, //总条目数
    "currentPage": 0, //当前页面
    "pageSize": 100, //每页包含的数量
    "list": [{
		"gid" //广联云ID,
		"accountId" //用户账号标识,
		"realName" //真实名称,
		"realMobile" //真实手机, 
		"email" //邮箱, 
		"company" //所在公司, 
		"qq", 
		"identifyName" //身份类型，如正版,
		"lastProvince" //最近一次访问所在省,
		"lastCity" //最近一次访问所在城市,
        "firstLoginTime" //首次登录时间, 
	    "lastLoginTime" //最后一次登录时间,
		"levelName" //等级名称，如算量小白, 
		"birthday" //生日,
		"etlTime" //数据更新时间,
		"pid"//大产品id，
		"spid"//Pcode, 
		"pdate"//查询时间标识，可忽略, 
		"pidName"//大产品名称,
		"spidName"//小产品名称，
		"regionRule"//地区规则,如计价的清单规则,
		"appVersion"//软件版本,
		"userIdentify"//用户身份，9代表潜在用户，10代表盗版用户，20代表学习版，30代表正版用户，40代表VIP用户，
		"region"//用户地区，
		"level"//用户等级，
		"lastIp"//最后使用IP，
		"credit"//用户积分，
		"point"//用户成长值，
		"badgeList"//用户获得的勋章列表，
		"avatar"//用户的广联云头像}

]}}

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

# 异常返回结果

{"code":414,"msg":"请输入正确的pid, spid, appname, pcode中的任意一个"}

# 设备查询埋点信息 API

开始使用前，请先创建应用，key和secret

# 请求

GET https://aecore.glodon.com/ops/oauth/data/device/behavior/{id}

# 说明

返回某时间段内该设备上的所有埋点行为列表信息，时间段最长为30天，返回的数量最多为5000条

参数名	必选	类型	描述
Authorization	是	String	Bearer access_token
Content-Type	是	String	application/json

# 路径参数

参数名	必选	类型	描述
id	是	String	设备ID

# body 参数

参数名	必选	类型	描述
filter	是	String	查询字段和查询值组成的一个JSON字符串，查询字段包括资源中可检索的所有字段和特定含义字段，查询值可以是字符串、数组或者整数，JSON对象，接口将根据内容返回相应的数据

# filter里参数说明

特定搜索字段：

"product": P00044, //中台产品标识，必填，可以是 pid, spid, appname, pcode中的任意一个，系统会将其映射为中台唯一的产品ID，返回的用户是该设备上使用了该产品的全部用户列表，String
"search": "Hello", //模糊搜索内容，可为空

1
2

支持的查询字段：

pdate: 行为日志产生时间，如20190101，必填
visitCount: 一天内行为日志触发次数
spid: 子产品标识号
lastUseTime: 最后一次使用时间
firstUseTime: 首次使用时间
fncode: 埋点CODE
fnname: 埋点名称

1
2
3
4
5
6
7

支持的查询动作：

gt: 大于
gte: 大于等于
lt: 小于
lte: 小于等于
ne: 不等于
lk: 包含
nlk: 不包含
en: 为空
nen: 不为空

1
2
3
4
5
6
7
8
9

# 响应

HTTP 代码	说明	类型
200	ok	请求成功，根据业务 code 解析实际结果

# 成功返回结果

{"code":200,
"message":"success",
"data": {
    "totalPage": 1, //总页数
    "totalElement": 100, //总条目数
    "currentPage": 0, //当前页面
    "pageSize": 100, //每页包含的数量
    "list": [{
	  "fncode", 
	  "fnname", 
	  "lastIp", 
	  "lastCountry", 
	  "lastProvince", 
	  "lastCity", 
	  "firstLoginTime", 
	  "lastLoginTime",
	  "firstUseTime", 
	  "lastUseTime", 
	  "visitCount", 
	  "duration",
	  "etlTime"
	  }
]}}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 异常返回结果

{"code":414,"msg":"请输入正确的pid, spid, appname, pcode中的任意一个"}
{"code":414,"msg":"请传入参数pdate"}

1
2

# 属性名称列表接口 API

开始使用前，请先创建应用，key和secret

# 请求

GET https://aecore.glodon.com/ops/oauth/data/stat/user/group

# 说明

按照属性分布-属性键值列表接口

参数名	必选	类型	描述
Authorization	是	String	Bearer access_token
Content-Type	是	String	application/json

# body 参数

参数名	必选	类型	描述
product	是	String	中台产品标识，必填，可以是 pid, spid, appname, pcode中的任意一个，系统会将其映射为中台唯一的产品ID，返回的用户是该设备上使用了该产品的全部用户列表

# 响应

HTTP 代码	说明	类型
200	ok	请求成功，根据业务 code 解析实际结果

# 成功返回结果

{
    "code":200,
    "message":"OK",
    "data": [
         {
            "code":"app_version", //属性键值
            "name":"软件版本", //属性名称
            "type":"list", // 值显示属性，list表示列表
            "option":null
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12

# 异常返回结果

{"code":414,"msg":"请输入正确的pid, spid, appname, pcode中的任意一个"}

# 属性值列表接口 API

开始使用前，请先创建应用，key和secret

# 请求

GET https://aecore.glodon.com/ops/oauth/data/stat/user/filter

# 说明

按照属性分布-属性键值列表接口

参数名	必选	类型	描述
Authorization	是	String	Bearer access_token
Content-Type	是	String	application/json

# body 参数

参数名	必选	类型	描述
product	是	String	中台产品标识，必填，可以是 pid, spid, appname, pcode中的任意一个，系统会将其映射为中台唯一的产品ID，返回的用户是该设备上使用了该产品的全部用户列表
property	是	String	属性键值，如app_version

# 响应

HTTP 代码	说明	类型
200	ok	请求成功，根据业务 code 解析实际结果

# 成功返回结果

如：filter?property=user_identify 查询属性user_identify的下拉

{
    "code":200,
    "message":"OK",
    "data": {
        "code":"user_identify", 
        "name":"user_identify",
        "type":"list",
        "option": [
             {
                "code":9,
                "name":"潜在",
                "type":"term",
                "option":null
            }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 异常返回结果

{"code":414,"msg":"请输入正确的pid, spid, appname, pcode中的任意一个"}

# 根据gid获取用户关联锁API

开始使用前，请先创建应用，key和secret

# 请求

GET https://aecore.glodon.com/ops/oauth/data/lockList/{gid}

# 说明

根据用户的gid获取用户关联的锁列表 API

参数名	必选	类型	描述
Authorization	是	String	Bearer access_token
Content-Type	是	String	application/json

# 路径参数

参数名	必选	类型	描述
gid	是	String	用户标识gid

# 响应

HTTP 代码	说明	类型
200	ok	请求成功，根据业务 code 解析实际结果

# 成功返回结果

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            "id": "5d0844f283d5a67cba6a5607",
            "pid": null,
            "lockId": "C320174360",
            "gid": "6336477673901982627",
            "name": null,
            "realName": "张春旭",
            "mobile": null,
            "realMobile": "15022583544",
            "email": "23232",
            "customerName": "河南广隆建设集团",
            "customerType": "施工大系统",
            "salePerson": "何洋",
            "buyTime": "0",
            "lockType": 0,
            "customerId": null,
            "branch": "天津",
            "qq": "454545",
            "lockIdentify": "已认证五代锁可补",
            "licenseIdentify": null,
            "nodeCount": 0,
            "duration": 0,
            "lastIp": null,
            "lastCountry": null,
            "lastProvince": "天津",
            "region": null,
            "regionId": null,
            "cityId": null,
            "lastCity": "天津",
            "lastUseTime": "2019-06-10 17:12:47.35",
            "firstUseTime": "2019-04-26 10:15:13.997",
            "importedAt": 1560823022202,
            "updatedAt": 1560823022202,
            "importedBy": null,
            "updatedBy": null,
            "tags": [
                "DY6386"
            ],
            "createdAt": 0,
            "createdBy": null,
            "spidList": null,
            "versionList": null,
            "lastSpid": null,
            "lastVersion": null
        }
    ]
}

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

# 根据identify获取用户信息API

开始使用前，请先创建应用，key和secret

# 请求

GET https://aecore.glodon.com/ops/oauth/data/userList/{identify}

# 说明

根据用户的identify获取用户信息列表 API

参数名	必选	类型	描述
Authorization	是	String	Bearer access_token
Content-Type	是	String	application/json

# 路径参数

参数名	必选	类型	描述
identify	是	String	用户标识，可以是gid,accountId,mobile,email,realMobile

# 响应

HTTP 代码	说明	类型
200	ok	请求成功，根据业务 code 解析实际结果

# 成功返回结果

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            "id": "5efe1b3383d5a6425ebef59a",
            "pid": "P00044",
            "accountId": "xn0001",
            "gid": "6224838849995133209",
            "userIdentify": 30,
            "identifyName": "正版",
            "avatar": null,
            "level": 7,
            "levelName": "LV7",
            "nickName": null,
            "fullName": null,
            "realName": "晓燕测试",
            "realMobile": "15101122243",
            "passwordMobile": null,
            "email": "",
            "company": "呼叫中心服务器专用-李江智（勿删）",
            "qq": "232323232",
            "birthday": "",
            "lastIp": null,
            "region": null,
            "lastCountry": "中国",
            "lastProvince": "湖北",
            "regionId": null,
            "lastCity": "淮安",
            "cityId": null,
            "mobile": null,
            "location": null,
            "branch": null,
            "importedAt": 1593711411152,
            "updatedAt": 1594034193785,
            "importedBy": null,
            "updatedBy": "RabbitListener",
            "credit": 159,
            "point": 85,
            "tags": [
                "18万",
                "幸运钢构活动",
                "积分兑换",
                "土建资料下载",
                "18T台秀",
                "19积分消除",
                "建议反馈专家",
                "幸运钢构锁",
                "版本调研",
                "智绘大土建",
                "18学习需求",
                "云规则兑换",
                "A类用户",
                "超模秘密",
                "000058号砼砼",
                "活动控",
                "幸运土建锁",
                "真实用户",
                "GTJ2021内测",
                "19T台秀",
                "钢铁侠11480",
                "云对比试用",
                "云协同验证授权",
                "幸运锦鲤活动",
                "体验调研",
                "幸运锦鲤锁",
                "专家用户",
                "B类用户",
                "土建入口2.0",
                "积分消除",
                "GTJ2018装配式用户验证",
                "云应用调研",
                "专家反馈",
                "土建运营入口V3.0"
            ],
            "badgeList": [
                {
                    "level": 1,
                    "thumb": "http://aecore-test.glodon.com/static/prod-ops/upload/1576598400000/c03b51c398af6c2457c98b046898ba04.png",
                    "tips": "完成超模秘密任务",
                    "creditRequire": 0,
                    "pointRequire": 0,
                    "countRequire": 0,
                    "credit": 0,
                    "point": 0,
                    "badgeName": "超模秘密达人",
                    "badgeId": "K13131",
                    "sort": 2,
                    "updatedAt": 1583564514127
                },
                {
                    "level": 1,
                    "thumb": "http://aecore-test.glodon.com/static/prod-ops/upload/1576598400000/91f0726b90c8cb8bdf33aec9535913a8.png",
                    "tips": "完成18T台秀任务",
                    "creditRequire": 0,
                    "pointRequire": 0,
                    "countRequire": 0,
                    "credit": 0,
                    "point": 0,
                    "badgeName": "18T台秀达人",
                    "badgeId": "G88225",
                    "sort": 2,
                    "updatedAt": 1583564514127
                },
                {
                    "level": 1,
                    "thumb": "http://aecore-test.glodon.com/static/prod-ops/upload/1576598400000/4786de378f73cd51ac94f06ddb79d56d.png",
                    "tips": "当前等级1，距下一等级升级还差${levelGap}",
                    "creditRequire": 0,
                    "pointRequire": 2,
                    "countRequire": 0,
                    "credit": 10,
                    "point": 10,
                    "badgeName": "学习达人",
                    "badgeId": "U26839",
                    "sort": 1,
                    "updatedAt": 1583564514127
                },
                {
                    "level": 3,
                    "thumb": "http://aecore-test.glodon.com/static/prod-ops/upload/1576598400000/dd2684bcb6fb812636f67c6a231278e0.png",
                    "tips": "当前等级3，距下一等级升级还差${levelGap}",
                    "creditRequire": 0,
                    "pointRequire": 25,
                    "countRequire": 0,
                    "credit": 30,
                    "point": 30,
                    "badgeName": "签到达人",
                    "badgeId": "I62683",
                    "sort": 1,
                    "updatedAt": 1583564514127
                }
            ],
            "spidList": null,
            "versionList": null,
            "lastSpid": null,
            "lastVersion": null,
            "createdAt": 1593711411168,
            "firstLoginTime": null,
            "lastLoginTime": null,
            "createdBy": "IronMan"
        },
        {
            "id": "5f02d4db83d5a6427643d3da",
            "pid": "P00039",
            "accountId": "xn0001",
            "gid": "6224838849995133209",
            "userIdentify": 0,
            "identifyName": null,
            "avatar": "https://account.glodon.com/avatar/show/6224838849995133209/200",
            "level": 0,
            "levelName": "不明物体",
            "nickName": "测试昵称",
            "fullName": "测试昵称",
            "realName": null,
            "realMobile": null,
            "passwordMobile": null,
            "email": null,
            "company": null,
            "qq": null,
            "birthday": null,
            "lastIp": null,
            "region": null,
            "lastCountry": null,
            "lastProvince": null,
            "regionId": null,
            "lastCity": null,
            "cityId": null,
            "mobile": null,
            "location": null,
            "branch": null,
            "importedAt": 1594021083266,
            "updatedAt": 1594021083290,
            "importedBy": "Portal",
            "updatedBy": "Portal",
            "credit": 0,
            "point": 0,
            "tags": null,
            "badgeList": null,
            "spidList": null,
            "versionList": null,
            "lastSpid": null,
            "lastVersion": null,
            "createdAt": 0,
            "firstLoginTime": null,
            "lastLoginTime": null,
            "createdBy": null
        }
    ]
}

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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190

# 试用授权接口 API

开始使用前，请先创建应用，key和secret

# 请求

POST https://aecore.glodon.com/ops/portal/user/auth

# 说明

授权接口

参数名	必选	类型	描述
Authorization	是	String	gid_pcode_token 的base64

# 说明

gid: 用户的广联云id pcode：产品代码, 比如GTJ2018:12386 GTJ2021:13025 市政：1629 token：广联云登录获取的access_token

# Body参数

参数名	必选	类型	描述
code	是	String	授权的功能码或者版本号比如710008（公有云计算） 710036（云对比） 1.0.9999.1（实际版本号）

# 响应

HTTP 代码	说明	类型
200	ok	请求成功，根据业务 code 解析实际结果

# 成功返回结果

{
    "code":200,
    "message":"OK",
    "data": {
        "auth": true
        
    }
}

1
2
3
4
5
6
7
8

← 采集服务埋点获取API 内容服务SDK →

# 数据服务API

# 设备关联用户信息 API

# 请求

# header 参数

# 路径 参数

# body 参数

# 响应

#

# 成功返回结果

# 异常返回结果

# 设备查询埋点信息 API

# 请求

# 说明

# header 参数

# 路径参数

# body 参数

# filter里参数说明

# 响应

# 成功返回结果

# 异常返回结果

# 属性名称列表接口 API

# 请求

# 说明

# header 参数

# body 参数

# 响应

# 成功返回结果

# 异常返回结果

# 属性值列表接口 API

# 请求

# 说明

# header 参数

# body 参数

# 响应

# 成功返回结果

# 异常返回结果

# 根据gid获取用户关联锁API

# 请求

# 说明

# header 参数

# 路径参数

# 响应

# 成功返回结果

# 根据identify获取用户信息API

# 请求

# 说明

# header 参数

# 路径参数

# 响应

# 成功返回结果

# 试用授权接口 API

# 请求

# 说明

# header 参数

# 说明

# Body参数

# 响应

# 成功返回结果

# 路径参数