全部文档

数据服务API

设备关联用户信息 API

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

请求

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

header 参数

参数名 必选 类型 描述
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"//用户的广联云头像}

]}}

异常返回结果

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

设备查询埋点信息 API

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

请求

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

说明

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

header 参数

参数名 必选 类型 描述
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", //模糊搜索内容，可为空
  • 支持的查询字段：
pdate: 行为日志产生时间，如20190101，必填
visitCount: 一天内行为日志触发次数
spid: 子产品标识号
lastUseTime: 最后一次使用时间
firstUseTime: 首次使用时间
fncode: 埋点CODE
fnname: 埋点名称
  • 支持的查询动作：
gt: 大于
gte: 大于等于
lt: 小于
lte: 小于等于
ne: 不等于
lk: 包含
nlk: 不包含
en: 为空
nen: 不为空

eg:{"product":"12386", "pdate":{"gte":20210228, "lte":20210228}}

响应

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"
	  }
]}}

异常返回结果

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

属性名称列表接口 API

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

请求

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

说明

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

header 参数

参数名 必选 类型 描述
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
        }
    ]
}

异常返回结果

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

属性值列表接口 API

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

请求

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

说明

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

header 参数

参数名 必选 类型 描述
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
            }
    }
}

异常返回结果

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

根据gid获取用户关联锁API

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

请求

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

说明

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

header 参数

参数名 必选 类型 描述
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
        }
    ]
}

根据identify获取用户信息API

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

请求

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

说明

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

header 参数

参数名 必选 类型 描述
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/c03b51c398af6c2457c98b046898ba0https://aecore.glodon.com/sp-doc/product-ops-console/58ca6d0eab06489ba4f11919b4eb4827_4.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/91f0726b90c8cb8bdf33aec9535913ahttps://aecore.glodon.com/sp-doc/product-ops-console/6ab629011b674f0390ab941de065b05f_8.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
        }
    ]
}

试用授权接口 API

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

请求

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

说明

授权接口

header 参数

参数名 必选 类型 描述
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
        
    }
}