音乐使用数据上报至HIFIVE,可用于数据核对。
POST
以下请求参数列表仅列出了部分公共参数,完整公共参数列表见 公共参数列表
参数名 | 类型 | 是否必传 | 说明 |
---|
X-HF-Action | String | 是 | 操作的接口名称,本接口取值:TrafficReportListen。 |
X-HF-Version | String | 是 | 操作的 API 的版本,本接口取值:V4.2.0。 |
参数名 | 类型 | 是否必传 | 说明 | 可选值 | 示例 |
---|
MusicId | String | 是 | 音乐id | - | 1D61C690142 |
Duration | Int | 是 | 音/视频时长 | - | 187 |
AudioFormat | String | 是 | 当前使用音频的文件编码 | mp3 / aac | mp3 |
AudioRate | String | 是 | 当前使用音频的比特率 | 320 / 128 | 320 |
Timestamp | Long | 是 | 音乐当前使用的时间,13位毫秒级时间戳 | - | 1595827681732 |
HFClient client = new DefaultHFClient(url, appkey, secret);
HFTrafficReportListenRequest request = new HFTrafficReportListenRequest();
request.setMethod(HFRequest.METHOD_POST);
request.setClientId("hf2y7jk19a56qetq05");
request.setMusicId("B7B810AABADF");
request.setTimestamp(System.currentTimeMillis());
request.setDuration(10 L);
request.setAudioFormat(AudioFormatEnum.MP3_128.format);
request.setAudioRate(AudioFormatEnum.MP3_128.rate);
try {
HFTrafficReportListenResponse response = client.execute(request);
System.out.println(JSON.toJSON(response));
} catch (ApiException e) {
e.printStackTrace();
}
字段 | 名称 | 重要性 | 说明 |
---|
code | 状态 | 必须 | 200-成功 |
msg | 消息描述 | 必须 | 消息描述 |
data | 统一的数据对象 | 必须 | 空字符串 |
taskId | 任务id | 必须 | - |
curl - G https: //gateway-open.haifanwu.com -H 'Authorization:HF3-HMAC-SHA1 Signature=B9A2F7CC0593A1CD54F3C66144778F2A' -H 'X-HF-ClientId:hf2y7jk19a56qetq05' -H 'X-HF-AppId:170ae316b9b14c1b9c185988771bde16' -H 'X-HF-Action:TrafficReportListen' -H 'X-HF-Timestamp:1595867681732' -H 'X-HF-Version:V4.2.0' -H 'X-HF-Nonce:A1cq9jpI3WY30trM5Ku5JiwCgMwuPuqz'
-X POST - d 'MusicId=B7B810AABADF&AudioFormat=mp3&AudioRate=320&Timestamp=1595827681732'
{
"code": 10200,
"msg": "操作成功",
"data": "",
"taskId": "5be462476b1926a9cb67bb242fdb1de3"
}