蜻蜓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/hotpage
app建议设计urlScheme支持跳转,格式考虑以 sdkqingtingfm://sdk.qingting.fm 开头,支持h5页面跳转
专辑页 sdkqingtingfm://sdk.qingting.fm/channels/271526
电台页 sdkqingtingfm://sdk.qingting.fm/radio/266
节目播放页 sdkqingtingfm://sdk.qingting.fm/channels/271526/programs/10021696
频道页 sdkqingtingfm://sdk.qingting.fm/mainTab/521
专辑列表页 sdkqingtingfm://sdk.qingting.fm/categories/521
专辑列表页 sdkqingtingfm://sdk.qingting.fm/categories/521?attrs=1234,5678
电台列表页 sdkqingtingfm://sdk.qingting.fm/radio/categories/521
排行榜 sdkqingtingfm://sdk.qingting.fm/rankinglist
类型描述
焦点图: Banner
首页金刚位小图标: IconGrid
专题区长方形图标: TopicGrid
电台长方形图标: RadioGrid
选台区: RadioCatGrid
竖排栏目推荐: ListRecommend
方图栏目推荐: GridRecommend
开屏大图: FullImage
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api.open.qtfm.cn/media/v7/hotpage?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}}'
响应示例响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "type": "Banner",
      "sequence": 0,
      "items": [
        {
          "title": "高晓松最新力作,限时抢早鸟券!",
          "img_url": "http://pic.qingting.fm/rms/2019/01/02/1b168a6d304b6054e514ee7021c7bd6d.jpg",
          "interval": 3,
          "sequence": 0,
          "url_scheme": "sdkqingtingfm://sdk.qingting.fm/channels/271526/programs/10021696"
        },
        {
          "title": "炼一口飞剑,可千里杀敌!",
          "img_url": "http://pic.qingting.fm/rms/2018/12/29/68ab03741cb601b91b5e8a54acfface9.jpg",
          "interval": 3,
          "sequence": 1,
          "url_scheme": "sdkqingtingfm://sdk.qingting.fm/channels/264801/programs/9609475"
        }
      ]
    },
    {
      "type": "IconGrid",
      "sequence": 1,
      "items": [
        {
          "sequence": 0,
          "title": "小说",
          "img_url": "http://pic.qingting.fm/rms/2018/05/03/7f7c643ab3c15530de27d32e3ab5961b.png",
          "url_scheme": "sdkqingtingfm://sdk.qingting.fm/mainTab/521"
        },
        {
          "sequence": 0,
          "title": "精品",
          "img_url": "http://pic.qingting.fm/rms/2018/05/03/82dcd0ba374497edcd4a9fbd986b612f.png",
          "url_scheme": "sdkqingtingfm://sdk.qingting.fm/mainTab/3617"
        },
        {
          "sequence": 0,
          "title": "广播",
          "img_url": "http://pic.qingting.fm/rms/2018/08/22/bce28a82340b87543c16cf37fc15c34c.png",
          "url_scheme": "http://a.qingting.fm/categories/5"
        }
      ]
    },
    {
      "type": "TopicGrid",
      "sequence": 2,
      "items": [
        {
          "title": "高晓松最新力作,限时抢早鸟券!",
          "img_url": "http://pic.qingting.fm/rms/2019/01/02/1b168a6d304b6054e514ee7021c7bd6d.jpg",
          "url_scheme": "http://www.qingting.fm/",
          "sequence": 0
        },
        {
          "title": "炼一口飞剑,可千里杀敌!",
          "img_url": "http://pic.qingting.fm/rms/2018/12/29/68ab03741cb601b91b5e8a54acfface9.jpg",
          "url_scheme": "http://www.qingting.fm/",
          "sequence": 1
        }
      ]
    },
    {
      "type": "GridRecommend",
      "sequence": 3,
      "title": "历史",
      "metadata": {
        "title": "lishi"
      },
      "url_scheme": "sdkqingtingfm://sdk.qingting.fm/categories/531",
      "items": [
        {
          "title": "重阳的世界观(第二季)",
          "rec_words": "20分钟解析中国鱼雷发展史",
          "img_url": "http://pic.qingting.fm/channellist/2018/06/21/0e7d8082e78b12fd49a30f0b5925013d.jpg!400",
          "playcount": "192.8万",
          "url_scheme": "sdkqingtingfm://sdk.qingting.fm/channels/259178/programs/9352895",
          "sequence": 0
        },
        {
          "title": "重阳的世界观(第二季)",
          "rec_words": "20分钟解析中国鱼雷发展史",
          "img_url": "http://pic.qingting.fm/channellist/2018/06/21/0e7d8082e78b12fd49a30f0b5925013d.jpg!400",
          "playcount": "192.8万",
          "url_scheme": "sdkqingtingfm://sdk.qingting.fm/channels/259178/programs/9352895",
          "sequence": 1
        }
      ]
    },
    {
      "type": "ListRecommend",
      "sequence": 3,
      "title": "历史",
      "metadata": {
        "title": "lishi"
      },
      "url_scheme": "sdkqingtingfm://sdk.qingting.fm/categories/521",
      "items": [
        {
          "sequence": 0,
          "title": "重阳的世界观(第二季)",
          "rec_words": "20分钟解析中国鱼雷发展史",
          "img_url": "http://pic.qingting.fm/channellist/2018/06/21/0e7d8082e78b12fd49a30f0b5925013d.jpg!400",
          "playcount": "192.8万",
          "url_scheme": "sdkqingtingfm://sdk.qingting.fm/vchannels/259178/programs/9352895",
          "podcasters": [
            {
              "avatar": "http://pic.qingting.fm/self/qtfm.png",
              "nickname": "播音文石",
              "podcaster_id": "40a7695e641e47de64a52e7c81fe642f"
            },
            {
              "avatar": "http://pic.qingting.fm/self/qtfm.png",
              "nickname": "播音姚科",
              "podcaster_id": "c0a6f0e61eee5a54a997bcd360667ef7"
            }
          ],
          "star": 10
        },
        {
          "sequence": 1,
          "title": "茅山后裔",
          "img_url": "http://pic.qingting.fm/channellist/2018/06/21/0e7d8082e78b12fd49a30f0b5925013d.jpg!400",
          "url_scheme": "sdkqingtingfm://sdk.qingting.fm/channels/102974/programs/2808000",
          "rec_words": "测试",
          "playcount": "17.7亿",
          "podcasters": [
            {
              "avatar": "http://pic.qingting.fm/self/qtfm.png",
              "nickname": "播音文石",
              "podcaster_id": "40a7695e641e47de64a52e7c81fe642f"
            },
            {
              "avatar": "http://pic.qingting.fm/self/qtfm.png",
              "nickname": "播音姚科",
              "podcaster_id": "c0a6f0e61eee5a54a997bcd360667ef7"
            }
          ],
          "star": 10
        }
      ]
    }
  ]
}

请求参数

Query 参数
tab_id
integer 
频道页id
可选
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
errcode
integer 
必需
errmsg
string 
必需
data
array [object {6}] 
必需
type
string 
必需
sequence
integer 
必需
items
array [object {9}] 
必需
title
string 
必需
metadata
object 
必需
url_scheme
string 
必需
上一页
获取排行榜
下一页
相关推荐专辑
Built with