蜻蜓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/search
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api.open.qtfm.cn/media/v7/search?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": "中国之声――中央人民广播电台最悠久的第一套节目,中国国家电台最具权威的新闻综合广播;全天24小时不间断播音,遍布海内外数百家电台、与上千名记者全面合作。",
      "id": 386,
      "thumb": "http://pic.qingting.fm/2014/0330/20140330111349821.jpg!200",
      "title": "CNR中国之声",
      "type": "channel_live"
    }
  ],
  "errcode": 0,
  "errmsg": "Success",
  "page": 1,
  "pagesize": 30,
  "total": 7
}

请求参数

Query 参数
keyword
string 
可选
示例值:
{keyword}
type
string 
可选
示例值:
{type}[
page
string 
可选
示例值:
{page}
category_id
string 
可选
示例值:
{category_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
data
array [object {5}] 
必需
description
string 
广播电台描述
可选
id
integer 
广播电台id
可选
thumb
string 
广播电台封面图
可选
title
string 
广播电台标题
可选
type
string 
类型
可选
errcode
integer 
必需
errmsg
string 
必需
page
integer 
必需
pagesize
integer 
必需
total
integer 
必需
上一页
搜索接口
下一页
搜索热词
Built with