文档中心 > YunOS开放平台

轻服务反馈API接口说明

更新时间：2017/08/14 访问次数：2105

1.接口传输的参数

1.接口传输的参数

加密签名模式：

YUNOS传递的入参只有2个，分别是k和data。

k是随机秘钥的密文，data是加密的入参数据。

签名模式：YUNOS传递的入参只有1个，参数key是data。

2.入参和返回结果说明

入参data中参数列表

字段名称	类型	是否必填	备注
sign	String	是	签名MD5值
appId	String	是	轻服务ID
did	String	是	设备唯一号
openId	String	是	用户唯一号
syncTime	String	是	客户端上报时时间戳，单位:ms
operLogs	String	是	Array的JSON字符串，客户端用户行为日志，详细字段参见《3.用户事件信息》

返回结果(参考sdk: com.yunos.open.api.response.BaseResult)

字段名称	类型	是否必填	备注
code	int	是	错误码：200：成功，500：异常
msg	String	否	错误信息

data格式示例

{
    "sign": "xxxx",
    "sysTime": "1476859486932",
    "appId": "Y_DDA98JCM7U0PY0XKYONL",
    "did": "B8E811890C9B3482FE699DB3D9EA8A71",
    "operLogs": "[{\"eventId\":1,\"eventTime\":1476859449714,\"stayTime\":1476856887432},{\"eventId\":2,\"sourceId\":\"47312399\",\"eventTime\":1476859449714,\"serverTime\":1476856887432,\"back\":\"{\\\"upack\\\":\\\"eyJhYl92ZXIiOiI0OCIsImFkX2NvbmZpZ2lkIjoiIiwiYml6X2NvbmZpZ2lkIjoiIiwibmV3c19jb25maWdpZCI6IjQ4In0\\\\u003d\\\",\\\"cpack\\\":\\\"eyJzdHJhdGVneSI6IjgiLCJjb250ZW50X3R5cGUiOiIweDAwMDAwMDAxIn0\\\\u003d\\\"}\"},{\"eventId\":3,//明细点击\"sourceId\":\"47312399\",\"eventTime\":1476859449720,\"serverTime\":1476856887432,\"back\":\"{\\\"upack\\\":\\\"eyJhYl92ZXIiOiI0OCIsImFkX2NvbmZpZ2lkIjoiIiwiYml6X2NvbmZpZ2lkIjoiIiwibmV3c19jb25maWdpZCI6IjQ4In0\\\\u003d\\\",\\\"cpack\\\":\\\"eyJzdHJhdGVneSI6IjgiLCJjb250ZW50X3R5cGUiOiIweDAwMDAwMDAxIn0\\\\u003d\\\"}\"},{\"eventId\":4,//明细详情页停留\"sourceId\":\"47312399\",\"eventTime\":1476859449720,\"serverTime\":1476856887432,\"stayTime\":10000}]"
}

operLogs反序列化后的值示例

[
        {
            "eventId": 1,//轻服务内停留
            "eventTime": 1476859449714,
            "stayTime": 1476856887432
        },
        {
            "eventId": 2,//明细展现
            "sourceId": "47312399",
            "eventTime": 1476859449714,
            "serverTime": 1476856887432,
            "back": "{\"upack\":\"eyJhYl92ZXIiOiI0OCIsImFkX2NvbmZpZ2lkIjoiIiwiYml6X2NvbmZpZ2lkIjoiIiwibmV3c19jb25maWdpZCI6IjQ4In0\\u003d\",\"cpack\":\"eyJzdHJhdGVneSI6IjgiLCJjb250ZW50X3R5cGUiOiIweDAwMDAwMDAxIn0\\u003d\"}"
        },
        {
            "eventId": 3,//明细点击
            "sourceId": "47312399",
            "eventTime": 1476859449720,
            "serverTime": 1476856887432,
            "back": "{\"upack\":\"eyJhYl92ZXIiOiI0OCIsImFkX2NvbmZpZ2lkIjoiIiwiYml6X2NvbmZpZ2lkIjoiIiwibmV3c19jb25maWdpZCI6IjQ4In0\\u003d\",\"cpack\":\"eyJzdHJhdGVneSI6IjgiLCJjb250ZW50X3R5cGUiOiIweDAwMDAwMDAxIn0\\u003d\"}"
        },
        {
            "eventId": 4,//明细详情页停留
            "sourceId": "47312399",
            "eventTime": 1476859449720,
            "serverTime": 1476856887432,
            "stayTime": 10000
        }
    ]

3.用户事件信息

目前已经实现的实时反馈的用户在终端上几种行为：

a.轻服务内停留事件
b.轻服务内容明细展现事件
c.轻服务内容明细点击事件
d.轻服务内容明细详情页停留事件

3.1.轻服务内停留事件

字段名	字段描述	字段例子
eventId	用户行为枚举值	固定为：1
eventTime	事件发生时间戳，单位：ms	1470812952720
stayTime	停留时长，单位：ms	100

3.2.轻服务内容明细展现事件

字段名	字段描述	字段例子
eventId	事件枚举值	固定为：2
sourceId	数据唯一ID	a5HonSjK6Gyb31kq82ERBwa3FxPBcIyP
eventTime	事件发生时间戳，单位：ms	1470812952720
serverTime	数据下发时的时间戳，单位：ms	1470812952720
back	源数据的内容，原封返回	{“cpack”:“aaa”,“upack”:“bbb”}

3.3.轻服务内容明细点击事件

字段名	字段描述	字段例子
eventId	事件枚举值	固定为：3
sourceId	数据唯一ID	a5HonSjK6Gyb31kq82ERBwa3FxPBcIyP
eventTime	事件发生时间戳，单位：ms	1470812952720
serverTime	数据下发时的时间戳，单位：ms	1470812952720
back	源数据的内容，原封返回	{“cpack”:“aaa”,“upack”:“bbb”}

3.4.轻服务内容明细详情页停留事件

字段名	字段描述	字段例子
eventId	事件枚举值	固定为：4
sourceId	数据唯一ID	a5HonSjK6Gyb31kq82ERBwa3FxPBcIyP
eventTime	事件发生时间戳，单位：ms	1470812952720
stayTime	停留时长，单位：ms	1000

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问