文档中心 > API类目 > 曲库开放平台TraceAPI

xiami.content.resource.action.report (曲库开放平台内容行为上报接口)

合作方对接入的曲库开放内容上报行为日志

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
resource_id String 必须 1769908308 资源ID
num Number 可选 1
  • 默认值:1
  • 行为数量
    action String 必须 LISTEN 行为类型(可枚举):LISTEN(主动试听)、PASSIVE_LISTEN(被动试听)
    resource_type String 必须 song 资源类型(可枚举): song(歌曲)
    from_id String 可选 123 来源id,如歌单id
    from_type Number 可选 1 1推荐2歌单3标签
    open_id String 可选 123 用户id
    utdid String 可选 hxhduxdid 用户设备id
    extra String 可选 {"a":"1"} 扩展信息
    relation_id String 可选 123 音频id
    relation_type String 可选 audio 关联类型(如音频)

    响应参数

    名称 类型 示例值 描述
    result Boolean true 上报结果: true(成功), false(失败)
    result_code ResultCode resultCode 返回结果码
    • └ msg
    • String
    • success
    • result message
    • └ code
    • Number
    • 0
    • result code

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XiamiContentResourceActionReportRequest req = new XiamiContentResourceActionReportRequest();
    req.setResourceId("1769908308");
    req.setNum(1L);
    req.setAction("LISTEN");
    req.setResourceType("song");
    req.setFromId("123");
    req.setFromType(1L);
    req.setOpenId("123");
    req.setUtdid("hxhduxdid");
    req.setExtra("{\"a\":\"1\"}");
    req.setRelationId("123");
    req.setRelationType("audio");
    XiamiContentResourceActionReportResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xiami_content_resource_action_report_response>
        <result>true</result>
        <result_code>
            <msg>success</msg>
            <code>0</code>
        </result_code>
    </xiami_content_resource_action_report_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部