蜻蜓FM API
  1. 账号授权API
蜻蜓FM API
  • 快速入门
    • 政策规范
      • 域名更新公告
      • 开发者协议
      • 品牌露出规范
    • 联系我们
      • 技术支持
  • API文档
    • 接入必读
      • 公共约定
      • 错误码说明
    • 账号授权API
      • 获取访问令牌_grant_type=client_credentials
        POST
      • 获取访问令牌_grant_type=authorization_code
        POST
      • 获取访问令牌_grant_type=refresh_token
        POST
      • 获取授权码
        GET
      • 注册新用户并取得访问令牌
        POST
    • 广播内容
      • 获取广播电台列表
      • 获取广播电台分类列表
      • 获取广播电台信息
      • 获取广播电台节目列表
    • 点播内容API
      • 实时点播内容更新通知
      • 获取点播专辑分类
      • 获取点播专辑列表
      • 获取点播专辑信息
      • 获取点播专辑节目列表
      • 批量获取点播专辑信息
      • 指定时间更新通知的集合
    • 内容运营API
      • 获取分类下的属性集合
        • 获取分类下的属性集合
        • 属性id用途
      • 搜索接口
      • 搜索接口
      • 搜索接口
      • 搜索热词
      • 获取排行榜
      • 运营推荐位
      • 相关推荐专辑
    • 数据回传API
      • 添加节目播放记录
      • 专辑曝光点击数据回传
    • 支付API
      • 打开收银台
      • 获取收银结算价
      • 创建订单
      • 确认订单
    • 分销API
      • 直充虚拟币
      • 直充接口
      • 查询合作方账户余额
    • 用户信息API
      • 获取用户信息
      • 获取用户收听历史
      • 获取用户收藏的专辑
    • 数据模型
      • token模型
      • 点播专辑模型
      • 点播节目模型
      • 广播电台模型
      • 广播节目模型
      • 订单模型
      • 用户信息模型
    • 付费查询API
      • 查询订单
      • 获取用户的订购列表
      • 查询付费专辑的播放权限
  • 资源下载
    • 移动SDK
      • 移动SDK下载
    • 小蜻蜓H5
      • 小蜻蜓H5接入
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  • 添加节目播放记录
    POST
  1. 账号授权API

获取访问令牌_grant_type=client_credentials

正式环境
https://api.open.qtfm.cn
正式环境
https://api.open.qtfm.cn
POST
/auth/v7/access
接入方服务端单侧请求同步数据或导入订单使用 grant_type=client_credentials,返回匿名用户的token(此时refresh_token和user_id为空)。
用户系统对接采取蜻蜓授权登录时使用 grant_type=authorization_code,参数client_id和授权码code参数为必填,redirect_uri为选填,返回code对应的具名用户token。如果具名用户token过期,可通过grant_type=refresh_token获取具名用户新的token。
tips: os, os_version, package_version, app_version, device_model等参数为选填。为了开放平台更好地提供服务,接入方客户端发起请求(包括服务端透传)时请尽量填写。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api.open.qtfm.cn/auth/v7/access?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}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "grant_type": "client_credentials",
    "client_id": "MWVlMmNhMjgtYWUzOS0xMWU2LTkyM2YtMDAxNjNlMDAyMGFk",
    "client_secret": "#{client_secret}"
}'
响应示例响应示例
{
    "data": {
        "access_token": "NTg2ZjNjMTItMTA0My00MDAyLThlY2EtMDBlODMzZWZkMmRj",
        "expires_in": 23304,
        "refresh_token": "",
        "user_id": ""
    },
    "errcode": 0,
    "errmsg": "Success"
}

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

修改于 2022-08-24 07:53:30
上一页
错误码说明
下一页
获取访问令牌_grant_type=authorization_code
Built with