蜻蜓FM API

运营推荐位

正式环境

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)；若在接入方服务端调用需透传接入方客户端的设备号

默认值:

access_token

string

可选

当前用户（匿名或具名）的授权凭据，授权之前请使用空字符串

默认值:

user_id

string

可选

用户在蜻蜓侧的ID，由授权登录或静默登录获取。匿名用户请使用空字符串

默认值:

coop_open_id

string

可选

合作方用户ID，用来反查蜻蜓id（仅当使用client_credentials模式得到的token时生效）。如无需求，可以不用

默认值:

device_os

string

可选

设备操作系统(Android or ios)

默认值:

device_os_version

string

设备操作系统版本

可选

默认值:

app_version

string

设备应用版本

可选

默认值:

device_model

string

机型

可选

默认值:

返回响应

🟢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

必需

修改于 2022-07-15 08:51:57

获取排行榜