蜻蜓FM API
    蜻蜓FM API
    • 快速入门
      • 政策规范
        • 域名更新公告
        • 开发者协议
        • 品牌露出规范
      • 联系我们
        • 技术支持
    • API文档
      • 接入必读
        • 公共约定
        • 错误码说明
      • 账号授权API
        • 获取访问令牌_grant_type=client_credentials
        • 获取访问令牌_grant_type=authorization_code
        • 获取访问令牌_grant_type=refresh_token
        • 获取授权码
        • 注册新用户并取得访问令牌
      • 广播内容
        • 获取广播电台列表
        • 获取广播电台分类列表
        • 获取广播电台信息
        • 获取广播电台节目列表
      • 点播内容API
        • 实时点播内容更新通知
        • 获取点播专辑分类
        • 获取点播专辑列表
        • 获取点播专辑信息
        • 获取点播专辑节目列表
        • 批量获取点播专辑信息
        • 指定时间更新通知的集合
      • 内容运营API
        • 获取分类下的属性集合
          • 获取分类下的属性集合
          • 属性id用途
        • 搜索接口
        • 搜索接口
        • 搜索接口
        • 搜索热词
        • 获取排行榜
        • 运营推荐位
        • 相关推荐专辑
      • 数据回传API
        • 添加节目播放记录
        • 专辑曝光点击数据回传
      • 支付API
        • 打开收银台
        • 获取收银结算价
        • 创建订单
        • 确认订单
      • 分销API
        • 直充虚拟币
        • 直充接口
        • 查询合作方账户余额
      • 用户信息API
        • 获取用户信息
        • 获取用户收听历史
        • 获取用户收藏的专辑
      • 数据模型
        • token模型
        • 点播专辑模型
        • 点播节目模型
        • 广播电台模型
        • 广播节目模型
        • 订单模型
        • 用户信息模型
      • 付费查询API
        • 查询订单
        • 获取用户的订购列表
        • 查询付费专辑的播放权限
    • 资源下载
      • 移动SDK
        • 移动SDK下载
      • 小蜻蜓H5
        • 小蜻蜓H5接入
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST
    • 添加节目播放记录
      POST

      添加节目播放记录

      正式环境
      https://api.open.qtfm.cn
      正式环境
      https://api.open.qtfm.cn
      POST
      /media/v7/logger

      添加广播及专辑节目播放记录(需device_id)#

      一、回传时机
      a.系统/用户播放切换到下一集,回传上一集播放记录
      b.用户手动停止播放,回传当前播放记录
      c.应用退出时关闭正在播放,回传当前播放记录
      二、注意事项
      a.如果已集成了SDK播放器,则不需再次对接播放数据回传接口,SDK会自动回传。
      b.如回传时机未联网无法上传,则缓存在本地等待联网后补传
      说明:必填参数请都填,非必填参数若可以获取到也请尽量填,若获取不到可以在json中不填此键值对
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      curl --location -g --request POST 'https://api.open.qtfm.cn/media/v7/logger?device_id={{device_id}}&access_token={{access_token}}&user_id={{user_id}}&coop_open_id={{coop_open_id}}&device_os={{device_os}}&device_os_version={{device_os_version}}&app_version={{app_version}}&device_model={{device_model}}' \
      --header 'Content-Type: application/json' \
      --data-raw '{
          "ts": 1529995388,
          "channel_id": 164292,
          "program_id": 9081951,
          "play_duration": 20,
          "position": 10,
          "os": "iOS",
          "os_version": "4.3",
          "app_name": "aliyun",
          "app_version": "1.0",
          "device_model": "Samsumg_br_FM__samsung_SCH-N719"
      }'
      响应示例响应示例
      {}

      请求参数

      Query 参数
      device_id
      string 
      可选
      当前接入方设备的设备号,务必保证设备号和设备一一对应,安卓设备建议填imei或md5(imei);若在接入方服务端调用需透传接入方客户端的设备号
      默认值:
      {{device_id}}
      access_token
      string 
      可选
      当前用户(匿名或具名)的授权凭据,授权之前请使用空字符串
      默认值:
      {{access_token}}
      user_id
      string 
      可选
      用户在蜻蜓侧的ID,由授权登录或静默登录获取。匿名用户请使用空字符串
      默认值:
      {{user_id}}
      coop_open_id
      string 
      可选
      合作方用户ID,用来反查蜻蜓id(仅当使用client_credentials模式得到的token时生效)。如无需求,可以不用
      默认值:
      {{coop_open_id}}
      device_os
      string 
      可选
      设备操作系统(Android or ios)
      默认值:
      {{device_os}}
      device_os_version
      string 
      设备操作系统版本
      可选
      默认值:
      {{device_os_version}}
      app_version
      string 
      设备应用版本
      可选
      默认值:
      {{app_version}}
      device_model
      string 
      机型
      可选
      默认值:
      {{device_model}}
      Body 参数application/json
      ts
      integer 
      播放停止的时间,使用Unix时间戳, e.g. 1393257000
      必需
      channel_id
      integer 
      广播电台或点播专辑id
      必需
      program_id
      integer 
      广播电台或点播专辑节目id
      必需
      play_duration
      integer 
      本次播放时长,单位秒
      必需
      position
      integer 
      播放停止的位置(距节目开头的秒数)
      必需
      os
      string 
      设备系统,e.g. iOS
      必需
      os_version
      string 
      设备系统版本,e.g. 4.3
      必需
      app_name
      string 
      应用名称
      必需
      app_version
      string 
      应用版本号
      必需
      device_model
      string 
      机型,e.g. Samsumg_br_FM__samsung_SCH-N719
      必需
      devicetype
      string 
      终端类型(Phone、TV、Spreaker、Watch)
      必需
      示例

      返回响应

      🟢200OK
      application/json
      Body
      object {0}
      上一页
      小蜻蜓H5接入
      下一页
      添加节目播放记录
      Built with