蜻蜓FM API

获取点播专辑列表

正式环境

https://api.open.qtfm.cn

GET

/media/v7/channelondemands[

返回说明

接口返回字段含义详见：点播专辑模型

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.open.qtfm.cn/media/v7/channelondemands[?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": 211547,
            "is_finished": 1,
            "podcasters": [
                {
                    "avatar": "http://pic.qingting.fm/2016/0501/20160501011635627.jpg",
                    "nickname": "李东成说",
                    "podcaster_id": "2162c8c9cc2b6b808e04e375dfa2cec4"
                }
            ],
            "latest_program": {
                "id": 8448417,
                "title": "嫁一个灵魂有温度的男人"
           },
            "program_count": 165,
            "free_vips":["vip", "chlid_vip"], //哪些会员可以免费收听
            "purchase_items": [
                {
                    "price": 199,
                    "promotional_price": 199,
                    "item_id": "593e6ec9efaed033a7a190af",
                    "item_type": "channel_programs"
                }
            ],
            "star": 6,
            "popularity": 1200, //热度值
            "thumbs": {
                "large_thumb": "http://pic.qingting.fm/2015/0810/20150810233411680.jpg!800",
                "medium_thumb": "http://pic.qingting.fm/2015/0810/20150810233411680.jpg!400",
                "small_thumb": "http://pic.qingting.fm/2015/0810/20150810233411680.jpg!200"
            },
            "title": "毒妻不下堂",
            "update_time": "2017-04-21 14:01:03",
            "attributes": [
                {
                    "id": 520,
                    "name": "测试",
                },
                {
                    "id": 123,
                    "name": "测试2"
                }
            ],
            "categories": [
                {
                    "id": 3330,
                    "name": "女性"
                },
                {
                    "id": 529,
                    "name": "情感"
                }
            ],
            "authors": [
                "大力金刚掌"
            ],
            "broadcasters": [
                "姚科",
                "文石"
            ]
        }
    ],
    "page": 1,
    "pagesize": 30,
    "total": 1834,
    "errcode": 0,
    "errmsg": "Success"
}

请求参数

Query 参数

page

string

可选

category_id

string

分类id

可选

vip_type

string

会员类型

可选

order

string

可选

可选[bytrend按热度排序, byupdate按专辑更新时间排序, bysale按销量排序], 不填时按默认序输出

pagesize

string

可选

示例值:

{pagesize}

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

data

array[array (点播专辑模型 ) {1}]

必需

object

可选

page

integer

必需

pagesize

integer

必需

total

integer

必需

errcode

integer

必需

errmsg

string

必需

获取点播专辑分类

获取点播专辑信息

获取点播专辑列表

返回说明#

请求参数

返回响应

返回说明