联系电话:19302847794

通用服务端
视频编辑SDK
K歌SDK

功能说明

音乐使用数据上报至HIFIVE,可用于数据核对。

请求方法

POST

Header

以下请求参数列表仅列出了部分公共参数,完整公共参数列表见 公共参数列表

参数名
类型
是否必传
说明
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"
   }
      
  • 功能说明
  • 请求方法
  • Header
  • 请求参数
  • 请求示例
  • 响应数据