蜻蜓FM API
  1. 内容运营API
蜻蜓FM API
  • 快速入门
    • 政策规范
      • 域名更新公告
      • 开发者协议
      • 品牌露出规范
    • 联系我们
      • 技术支持
  • API文档
    • 接入必读
      • 公共约定
      • 错误码说明
    • 账号授权API
      • 获取访问令牌_grant_type=client_credentials
      • 获取访问令牌_grant_type=authorization_code
      • 获取访问令牌_grant_type=refresh_token
      • 获取授权码
      • 注册新用户并取得访问令牌
    • 广播内容
      • 获取广播电台列表
      • 获取广播电台分类列表
      • 获取广播电台信息
      • 获取广播电台节目列表
    • 点播内容API
      • 实时点播内容更新通知
      • 获取点播专辑分类
      • 获取点播专辑列表
      • 获取点播专辑信息
      • 获取点播专辑节目列表
      • 批量获取点播专辑信息
      • 指定时间更新通知的集合
    • 内容运营API
      • 获取分类下的属性集合
        • 获取分类下的属性集合
        • 属性id用途
      • 搜索接口
        GET
      • 搜索接口
        GET
      • 搜索接口
        GET
      • 搜索热词
        GET
      • 获取排行榜
        GET
      • 运营推荐位
        GET
      • 相关推荐专辑
        GET
    • 数据回传API
      • 添加节目播放记录
      • 专辑曝光点击数据回传
    • 支付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
GET
/media/v7/ranking
排行榜包括:
1 专辑飙升榜,按点播专辑上升程度排序。
2 专辑热播榜,按点播专辑一周时间内播放量排序,可查询不同分类下的专辑热播排行榜。支持小说(521),音乐(523),相声小品(527),情感(529),历史(531),财经(533),科技(535),教育(537),健康(539),头条(545),娱乐(547),公开课(1585),儿童(1599),校园(1737),体育(3238),脱口秀(3251),搞笑(3252),戏曲(3276),女性(3330),汽车(3385),游戏动漫(3427),广播剧(3442),评书(3496),影视(3588),旅游(3597),中国之声(3608),文化(3613)
3 专辑新品榜,一个月内新上线专辑按播放量排序。
4 专辑畅销榜,按一个星期内专辑售卖额排序,分为畅销精品榜和畅销小说榜。支持精品(3617),小说(521)
5 广播电台榜,按照广播电台播放量排序。

返回说明#

专辑类:点播节目模型
广播类:广播电台模型
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api.open.qtfm.cn/media/v7/ranking?type=&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}}'
响应示例响应示例
{
  "data": [
    {
      "description": "【高晓松唯一音频节目】高晓松指南,矮大紧指北!周一指北排行榜,周三文青手册,周五闲情偶寄,高晓松没说的话,矮大紧讲给你听!",
      "id": 216713,
      "is_finished": 0,
      "latest_program": {
        "id": 9078008,
        "title": "闲情偶寄48:三里屯"
      },
      "podcasters": [
        {
          "avatar": "http://pic.qingting.fm/2015/0610/20150610152934932.jpg",
          "nickname": "高晓松",
          "podcaster_id": "6f9c4eb9a76fcfbb1434628fcf415e5f"
        }
      ],
      "popularity": 1852,
      "program_count": 151,
      "free_vips": [
        "vip",
        "chlid_vip"
      ],
      "purchase_items": [
        {
          "item_id": "59250bdec4143770b4c4b484",
          "item_type": "channel",
          "price": 200,
          "promotional_price": 200
        }
      ],
      "star": 10,
      "thumbs": {
        "large_thumb": "http://pic.qingting.fm/channel/2018/04/19/8b6fa9f2c999ce4f1dbce5922c24d1c6.jpg!800",
        "medium_thumb": "http://pic.qingting.fm/channel/2018/04/19/8b6fa9f2c999ce4f1dbce5922c24d1c6.jpg!400",
        "small_thumb": "http://pic.qingting.fm/channel/2018/04/19/8b6fa9f2c999ce4f1dbce5922c24d1c6.jpg!200"
      },
      "title": "矮大紧指北",
      "update_time": "2018-05-11 00:00:09",
      "categories": [
        {
          "id": 3330,
          "name": "女性"
        },
        {
          "id": 529,
          "name": "情感"
        }
      ]
    }
  ],
  "errcode": 0,
  "errmsg": "success"
}

请求参数

Query 参数
type
string 
必需
查询内容的类型(growth(专辑飙升榜)、 new(专辑新品榜)、hot(专辑热播榜)、hotsale(专辑畅销榜)、channellive(广播电台榜))
category_id
string 
可选
限定专辑热播榜和专辑畅销榜的分类
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}}

返回响应

🟢200成功
application/json
Body
data
array [object {16}] 
必需
description
string 
广播电台描述
可选
id
integer 
广播电台id
可选
is_finished
integer 
可选
latest_program
object 
可选
podcasters
array [object {3}] 
可选
popularity
integer 
广播电台热度值
可选
program_count
integer 
可选
free_vips
array[string]
可选
purchase_items
array [object {4}] 
可选
star
integer 
可选
thumbs
object 
广播电台封面图
可选
title
string 
广播电台标题
可选
update_time
string 
可选
广播电台更新时间(格式yyyy-MM-dd HH:mm:ss)
categories
array [object {2}] 
分类
可选
region
object 
省份
可选
city
object 
城市
可选
errcode
integer 
必需
errmsg
string 
必需
上一页
搜索热词
下一页
运营推荐位
Built with