PushLog 方案

方案说明

此方案使用 API 的回传接口向平台回传播放数据。回传建议：定时回传上个时间段产生的新数据，如每日回传昨日数据，所有数据打包在一个 json 组内一并提交。如提交文件过大，可分多组分别提交。
注意：SDK 方案不需要使用此方案。

调用接口

请求接口：/APILOGPUSH/uploadTrackPlay.json
请求方法：POST

输入参数

参数名	说明	案例
log	提交 JSON 格式数据	[{

"assetId": "T10035135135",
 "rate": "320",
 "playTime": "300",
 "playType": "1",
 "deviceModel": "xiaomi 111",
 "terminalType": "android",
 "useTime": "2017-10-12 13:12:24",
 "country": "中国",
 "sourceId": "2",
 "sourceType": "P15642353"
},
{}
] |

返回参数说明

参数名	类型	是否必填	说明
assetId	string	必填	说明：歌曲编号 ID
示例：T10022844685
rate	string	必填	说明：歌曲码率。值以选链结果返回的值为准。
示例：128
playType	string	必填	说明：播放方式。已定义方式：1 CPM 在线播放；2 CPM 离线播放；3 下载；4 短音频播放；5 短音频合成；6 短音频合成播放；7 公播在线播放；8 公播离线播放；9 设备激活
示例：1
playTime	string	必填	说明：记录歌曲播放了多少秒时间。单位秒。
示例：220
useTime	string	必填	说明：歌曲开始播放的时间。回传样式:yyyy-mm-dd hh:mm:ss。
示例：2018-01-01 17:00:00
country	string	必填	说明：歌曲使用的国家地区。建议使用标准 ISO 3166 code。
示例：CN/CHN/中国
province	string	非必填	说明：歌曲使用的省名称。国内使用小写拼音，国外小写英文。（不要省或市）
示例：beijing、shandong
deviceModel	string	非必填	说明：终端型号
示例：iphone 8
terminalType	string	非必填	说明：终端系统版本号
示例：ios 11.2.2
resourceId	string	非必填	说明：短音频专用 id 编号。如果 playType 的值为 4,5,6。resourceId 必填（即短音频用户必传此字段）
示例：21
sourceType	string	非必填	说明：sourceId 的类型。1 资源(歌单/电台/榜单)；2 专辑；3 单曲；4 艺人；5 搜索；6 其他；7 推荐；8 组合搜索 9 焦点图 10 短音频歌单
示例：2
sourceId	string	非必填	说明：随 sourceType 的值来定义，type 为 1、2、3、4、6、7、8、9、10 值为该资源的 id，如歌单 id；type 为 5、8 时为输入的查询值，组合搜索输入多值用,分隔。如薛之谦,流行
示例：P10000533465
sdkVersion	string	非必填	说明：使用 SDK 回传的 SDK 版本号
示例：1.1.23
telephone	string	非必填	说明：C 端用户的注册手机号
示例：08618888888888
userId	string	非必填	说明：C 端用户的注册 id
示例：8hsghsjdk
vipType	string	非必填	说明：C 端用户的 VIP 状态 1 是 VIP；2 不是 VIP
示例：1
vipExpireTime	string	非必填	说明：C 端用户的 VIP 过期时间
示例：2019-08-01 00:00:00
sex	string	非必填	说明：C 端用户性别 1 男；2 女；3 其他
示例：1
birthday	string	非必填	说明：C 端用户的生日日期
示例：1997-01-01
gps	string	非必填	说明：C 端用户使用的 GPS 信息。参数值标准：经度
示例：39.9390731	116.1172685
deviceId	string	非必填	说明：硬件设备专用 id 编号。如果 playType 的值为 9。deviceId 必填（即硬件设备用户必传此字段）
示例：sjdj8923hskdk

错误码

错误码	说明
apiSecure001	md5 没通过认证
apiSecure002	证书生成错误
apiSecure003	接口只能执行一次
apiSecure004	需要验证码
apiSecure005	授权验证失败
apiSecure006	账号申请中暂时无法使用服务
apiSecure007	账号审核不通过
apiSecure008	余额不足已停止服务
apiSecure009	once 设置长度错误
apiSecure010	api 未授权
apiSecure011	api 身份获取失败
logErr01	回传必须是 json 格式
logErr02	没有解析到的 log 记录
logErr03	要先设置 sdk 信息