腾讯云政企直播下单接口

更新时间：2023-04-04 09:31:23

接口描述

1、该接口接收用户购买信息，通知保利威工作人员，由工作人员线下开通账号。
2、（timestamp, appId, signatureNonce）参与sign签名，并和sign一起通过url传递，请求体参数不参与签名，通过post请求体传递【请设置请求头contentType:application/json】
3、接口支持https协议

接口URL

http://api.polyv.net/live/v4/root/order/create

请求方式

POST

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看

2、基础服务、增值服务至少包含一项，否则会返回异常；

3、一次性校验参数signatureNonce，用于防止网络重放攻击；

请求参数描述

参数名	必选	类型	说明
appId	true	String	企业级appId，由保利威提供
timestamp	true	Long	当前13位毫秒级时间戳，3分钟内有效
sign	true	String	签名，其中appSecret为企业级appSecret，由保利威提供，为32位大写的MD5值【详见签名生成规则】

请求体参数描述

参数名	必选	类型	说明
UIN	true	String	腾讯账号识别码，最大长度30
orderId	true	String	订单号，订单号重复将抛出异常，error.code=35002，最大长度70
email	true	String	客户邮箱，最大长度30
mobile	true	String	客户手机号，长度11
contact	false	String	客户姓名，长度30
basicService	false	Array	基础服务【详见BasicService参数描述】，基础服务、增值服务至少包含一项
premiumService	false	Array	增值服务【详见PremiumService参数描述】，基础服务、增值服务至少包含一项

BasicService参数描述

参数名	必选	类型	说明
type	true	String	基础服务类型【详见基础服务类型说明】， standard：标准版； enterprise：企业版； flagship：旗舰版；
number	Integer	续费时长，单位：年

PremiumService参数描述

参数名	必选	类型	说明
type	true	String	增值服务类型【详见增值服务类型说明】， premium_package：增值扩容包，单位：个； group_account：集团账号，单位：年； quality_analysis：品质分析，单位：年； live_transfer：直播转推，单位：次； link_mic_time：云直播连麦，单位：分钟； playback_store：回放存储，单位：GB； playback_flow：回放流量，单位：GB； channel_number：频道个数，单位：个； live_time：直播分钟数，单位：分钟； monitoring_time：导播台分钟数，单位：分钟；
number	true	Integer	续费数量

基础服务类型说明

类型代码	服务类型	功能描述	单位
standard	标准版	直播系统产品平台，包含100万分钟（1年有效），200个频道号直播系统产品平台，包含100万分钟（1年有效），200个频道号	年
enterprise	企业版	250万分钟，一年有效期，500个频道号	年
flagship	旗舰版	500万分钟，一年有效期，1000个频道号	年

增值服务类型说明

类型代码	服务类型	功能描述	单位
premium_package	增值扩容包	直播系统产品平台，包含100万分钟（1年有效），200个频道号直播系统产品平台，包含100万分钟（1年有效），200个频道号	年
group_account	集团账号	集团帐号可以创建多个分帐号，并可对这些分帐号分配或回收分钟数、流量和空间	年
quality_analysis	品质分析	从雷达图中，从上方逆时针分别显示4个指标：直播观看热情、直播回看情况、观看专注程度、观看互动	年
live_transfer	直播转推	通过保利威开播后，可以通过多路转推服务，支持将本地直播推流到第三方平台（如：凤凰网、bilibili、微信视频号、爱奇艺）进行推广，扩大直播的宣传度和影响力。同时往多个平台转推直播内容，一般用于多平台推广，达到更好的直播传播效果	次
link_mic_time	云直播连麦	即远程直播连麦，主讲与观众可进行实时音视频连麦，零延时互动，最多可支持17人连麦	分钟
playback_store	回放存储	空间：指直播回放的视频转存到点播的视频大小，按年度计费	GB
playback_flow	回放流量	流量：播放回放视频所产生的流量	GB
channel_number	频道号	指直播房间号，可以重复开多场直播	个
live_time	直播分钟数	用户可观看直播的时长	分钟
monitoring_time	导播台	导播台可预览直播画面，支持多画面切换、延时直播，一方面可随需切换视频信号，另一方面也为直播活动的意外情况做足备案	分钟

示例

http://api.polyv.net/live/v4/root/order/create?appId=frlr1zazn3&sign=E3F501CFEF5FCCF2DF9BFDCE9C91F48C&timestamp=1629445373947

请求体json参数：

{
    "orderId":"20999126-2c9d-4d3b-9438-c2945161d252",
    "email":"admin@polyv.net",
    "mobile":"18888888888",
    "contact":"张三",
    "basicService":{
        "type":"flagship",
        "number":1
    },
    "premiumService":[
        {
            "type":"",
            "number":""
        }
    ]
}

响应参数描述

参数名	类型	说明
code	Integer	状态码，与 http 状态码相同，用于确定基本的响应状态
status	String	响应结果，由业务决定，成功返回success，失败返回error
success	Boolean	是否成功响应
requestId	String	请求ID，每次请求生成的唯一的 UUID，仅可用于排查、调试，不应该和业务挂上钩
data	Boolean	请求响应对象，成功返回true，失败返回false
error	Object	错误信息【详见Error参数描述】

Error参数描述

参数名	类型	说明
code	Integer	错误代码，用于确定具体的错误原因
desc	String	错误描述，与 error.code 对应

Java请求示例

快速接入基础代码请下载相关依赖源码，点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。

响应示例

系统全局错误说明详见全局错误说明

成功示例

{
    "code": 200,
    "status": "success",
    "requestId": "847f0716fa76461baf8979aaa4415dc3.67.16342672396023837",
    "data": true,
    "success": true
}

异常示例

{
    "code": 400,
    "status": "error",
    "requestId": "4081dbac03e6441e8bdd301d8feee5a2.124.16360831818611581",
    "error": {
        "code": 20001,
        "desc": "application not found."
    },
    "success": false
}

直播服务端 API