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

添加节目播放记录

正式环境
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"
}'
响应示例响应示例
{
  "errcode": 0,
  "errmsg": "Success"
}

请求参数

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)
可选
示例

返回响应

🟢200成功
application/json
Body
errcode
integer 
必需
errmsg
string 
必需
上一页
相关推荐专辑
下一页
专辑曝光点击数据回传
Built with