頻道變更回呼通知

更新時間：2026-06-11 19:22:28

作用

在舊版後台建立頻道、刪除頻道，或者在新版後台建立頻道、刪除頻道、修改頻道（僅編輯直播間資訊）、修改觀看條件時，保利威會對所設定的回呼地址進行回呼通知。

詳情

請求方式

POST

請求類型

application/json

正常回應

如果您正常接收到请求，10秒内返回http状态码为200即可。
若超时或者返回http状态码非200，保利威将在间隔5秒、10秒发起重试。（只要有一次请求成功，下次将不再发起重试）

回呼參數說明

註：請求參數在Query參數中獲取

參數名	類型	說明
timestamp	Long	請求時間戳
sign	String	校驗的加密字串，產生的規則md5(AppSecret+timestamp)，AppSecret是直播系統的密鑰

註：請求參數在body中獲取

type為delete時回呼的欄位

參數名	類型	說明
type	String	操作的類型，delete為刪除
channelId	String	頻道號
operationTime	Long	操作的時間點，為13位的時間戳

type為create、update時回呼的欄位

參數名	類型	說明
type	String	操作的類型，create為新建，update為更新
channelId	String	頻道號
operationTime	Long	操作的時間點，為13位的時間戳
categoryName	String	頻道所屬分類名稱
scene	String	頻道的直播場景，topclass-大班課，double-雙師課，train-企業培訓，seminar-研討會，alone-活動行銷，portrait-帶貨
pureRtcEnabled	String	是否開啟無延遲，Y表示開啟，N表示不開啟
linkMicLimit	Integer	連麥人數上限
transmitType	String	轉播頻道類型，normal-沒有開啟轉播，transmit-發起轉播，receive-接收轉播
coverImg	String	直播封面
liveType	String	開播模板，ppt-文件+影片，alone-純影片，topclass-純影片-極速(原大班課)，seminar-研討會
startTime	String	直播開始時間，如：2022-01-20 00:00:00
watchType	String	觀看模板，normal-橫屏，portrait-豎屏
name	String	頻道名稱
bgImg	String	暖場圖片
splashImg	String	引導圖
publisher	String	主持人

type為auth時回呼的欄位

參數名	類型	說明
channelId	String	頻道號
userId	String	用戶ID
rank	Integer	用於實現一個頻道設定兩個觀看條件，為1或2（1為主要條件，2為次要條件）
globalSettingEnabled	String	是否開啟全域設定（該值僅對舊版後台有效） Y：開啟 N：不開啟
enabled	String	是否開啟觀看條件 Y：開啟 N：不開啟
authType	String	觀看條件類型 none：無限制 code：驗證碼觀看 pay：付費觀看 phone：白名單觀看 info：登記觀看 wxshare：分享觀看 custom：自訂授權觀看 external：外部授權觀看 direct：獨立授權)
subAuthType	String	authType為none時對應的值，public-公開觀看，wx-微信授權
wxAuthExpireValue	String	subAuthType為wx時，對應的微信授權有效期，例如: 3d表示3天，3h表示3小時
codeAuthTips	String	驗證碼觀看條件提示資訊
authCode	String	驗證碼觀看的驗證碼
qcodeTips	String	驗證碼觀看的二維碼提示
qcodeImg	String	驗證碼觀看的二維碼圖片
payAuthTips	String	付費觀看提示資訊
price	Float	付費觀看的價格，單位：元
watchEndTime	Long	付費觀看，截止時間，為null表示：一次付費，永久有效
validTimePeriod	Integer	付費觀看的截止時長（天）
customKey	String	自訂授權觀看的key
customUri	String	自訂授權觀看的介面地址
externalKey	String	外部授權觀看的key
externalUri	String	外部授權觀看的介面地址
externalRedirectUri	String	外部授權觀看，用戶直接訪問觀看頁時的跳轉地址
externalButtonEnabled	String	外部授權觀看，登入按鈕。Y為開啟，N為關閉。開啟後用戶訪問連結時，引導頁面將顯示登入按鈕
directKey	String	獨立授權key
trialWatchEnabled	String	付費觀看的試看開關，預設為N Y：開 N：關
trialWatchTime	Integer	試看時間，單位為分鐘
trialWatchEndTime	Long	試看截止日期，為null 表示對該頻道永久有效
whiteListInputTips	String	白名單輸入提示
whiteListEntryText	String	白名單入口文案
onceWhitelistEnabled	String	白名單不允許重複使用，預設為N，Y:是、N:否
authTips	String	白名單觀看提示資訊
infoDesc	String	登記觀看描述欄位
infoAuthTips	String	登記觀看條件提示資訊

請求體範例

請求Query範例

sign=8cc3607a4eb5bb3b5ded247b36c11c03&timestamp=1662081806366

請求json範例

{
    "type": "create",
    "operationTime": 1660286426422,
    "channelId": 3289191,
    "categoryName": "默认分类",
    "scene": "topclass",
    "pureRtcEnabled": "N",
    "linkMicLimit": 0,
    "transmitType": "normal",
    "startTime": "",
    "coverImg": "//liveimages.videocc.net/uploaded/images/2022/08/gcfk857g37.png",
    "liveType": "ppt",
    "watchType": "normal"
}

如何設定

前提條件：帳號需要開通頻道修改回呼功能，如果未開通此功能，則回呼設定處沒有「直播間資訊修改回呼URL」

透過後台設定：

登入帳戶 - 進入【雲直播】 - 點選【開發設定】- 點選【回呼設定】- 找到「直播間資訊修改回呼URL」

注意：提交的介面地址必須要以 http:// 或者 https:// 開頭

若無法找到對應設定，可能為帳號權限不足，如需取得協助，請聯絡右下角線上客服解決。