李经理:15682290831

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

功能说明

此接口根据用户画像、行为及行业等综合信息像接入平台的用户推荐音乐内容。接口推荐准确度与获取Token行为采集深度相关,如果确实相关信息推荐的准确度会大受影响

请求方法

GET

Header

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

参数名
类型
是否必传
说明
X-HF-Action
String
操作的接口名称,本接口取值:BaseFavorite。
X-HF-Version
String
操作的 API 的版本,本接口取值:V4.1.1。
X-HF-Token
String
Token 需要到用户画像上报接口获取,7200秒无操作将自动失效。

请求参数

参数名
类型
是否必传
说明
可选值
示例
Page
Int
当前页码,默认为1
大于0的整数
1
PageSize
Int
每页显示条数,默认为10
1~100
10

请求示例

                 HFClient client = new DefaultHFClient(url, appkey, secret);
 HFBaseFavoriteRequest request = new HFBaseFavoriteRequest();
 request.setMethod(HFRequest.METHOD_GET);
 request.setPage(1);
 request.setPageSize(20);
 request.setClientId("hf2y7jk19a56qetq05");
 request.setToken("13cda3f10b63120093d64ebf4116eabd");
 try {
     HFBaseFavoriteResponse response = client.execute(request);
     System.out.println(JSON.toJSON(response));
 } catch (ApiException e) {
     e.printStackTrace();
 }
              

响应数据

字段
名称
重要性
说明
code
状态
必须
200-成功
msg
消息描述
必须
消息描述
data
统一的数据对象
必须
json格式
record
推荐音乐
-
json数组
match
推荐匹配度0-100
-
80
musicId
音乐id
-
1D61C690142
musicName
音乐名
-
The Gift Of Christmas
albumId
专辑id
-
1D61C681B4F
albumName
专辑名
-
A Hint Of Christmas
artist
此字段可能返回为[],表演者
-
json数组
name
表演者
-
王大
code
表演者编号
-
1D61C690142
avatar
表演者头像
-
https://url.jpg
author
此字段可能返回为[],作词者
-
json数组
name
作词者
-
王大
code
作词者编号
-
1D61C690142
avatar
作词者头像
-
https://url.jpg
composer
此字段可能返回为[],作曲者
-
json数组
name
作曲者
-
王大
code
作曲者编号
-
1D61C690142
avatar
作曲者头像
-
https://url.jpg
arranger
此字段可能返回为[],编曲者
-
json数组
name
编曲者
-
王大
code
编曲者
-
1D61C690142
avatar
编曲者头像
-
https://url.jpg
cover
封面
-
json数组
url
封面地址
-
https://url.jpg
size
封面尺寸,该字段可能为"",代表没有设置尺寸
-
200
duration
时长(秒),此字段可能和播放器读取时长有一定误差
-
120
auditionBegin
推荐试听开始时间
-
46
auditionEnd
推荐试听结束时间
-
90
bpm
每分钟节拍
-
108
tag
标签数组
-
json数组
tagId
标签ID
-
1
tagName
标签名称
-
20
child
子标签数组[],属性同tag
-
json数组
version
版本信息
-
json数组
musicId
音乐id
-
1D61C690142
name
版本名称
-
The Gift Of Christmas
majorVersion
是否为主版本,1:是 0:否
-
1
free
1:免费0:收费
-
1
price
音乐价格(分)
-
0
duration
时长(秒)
-
120
auditionBegin
推荐试听开始时间
-
46
auditionEnd
推荐试听结束时间
-
90
meta
分页数据
-
json数组
totalCount
总记录数
-
80
currentPage
当前页数
-
1
taskId
任务id
必须
-
        curl -G https://gateway-open.haifanwu.com -H 'Authorization:HF3-HMAC-SHA1 Signature=12436239C9223CB9B91A1B4B0CF23E40' -H 'X-HF-ClientId:hf2y7jk19a56qetq05' -H 'X-HF-Token:cc24749900a70c83222654b48cc57a2a' -H 'X-HF-AppId:170ae316b9b14c1b9c185988771bde16' -H 'X-HF-Action:BaseFavorite' -H 'X-HF-Timestamp:1595820745533' -H 'X-HF-Version:V4.1.1' -H 'X-HF-Nonce:PuskjhBdBgGxHDWWHWIIxJGWLWTxaXWu'
-X GET -d 'Page=1&PageSize=20' 
  {
    "code": 10200,
    "msg": "操作成功",
    "data": {
      "record": [{
        "musicId": "4B40E8CBD",
        "musicName": "风吹玉米田",
        "albumId": "242016",
        "albumName": "EVA 芬克家族",
        "artist": [{
          "name": "杰西",
          "code": "1D652A73C86",
          "avatar": "https://static-hifiveai-open.haifanwu.com/artist/default.png?sign=f05f48161002024e745df097785fe2c4&t=1595818302"
        }],
        "author": [],
        "composer": [{
          "name": "杰西",
          "code": "1D652A73C86",
          "avatar": "https://static-hifiveai-open.haifanwu.com/artist/default.png?sign=f05f48161002024e745df097785fe2c4&t=1595818302"
        }],
        "arranger": [],
        "duration": 0,
        "bpm": 0,
        "tag": [{
          "tagId": 5439,
          "tagName": "流行 Pop",
          "child": []
        }, {
          "tagId": 5440,
          "tagName": "-",
          "child": []
        }],
        "version": [{
          "name": "主版本",
          "musicId": "4B40E8CBD",
          "free": 0,
          "price": 48000,
          "majorVersion": true,
          "duration": 0,
          "auditionBegin": 0,
          "auditionEnd": 0
        }],
        "match": 49.0,
        "auditionBegin": 0,
        "auditionEnd": 0,
        "cover": [{
          "url": "https://static-hifiveai-open.haifanwu.com/artwork/COPYRIGHT/4B40E8C95/4B40E8C95.jpg",
          "size": ""
        }]
      }],
      "meta": {
        "totalCount": 1,
        "currentPage": 1
      }
    },
    "taskId": "ce1d9a1a45fa4a84b72e83639e488ff7"
  }

      
  • 功能说明
  • 请求方法
  • Header
  • 请求参数
  • 请求示例
  • 响应数据