接口規範 推流認證相關接口
- 9.1.開啟推流認證
用途
針對某個應用,開啟推流認證。
開啟推流認證後,所有向該應用下的推送直播流的請求都需要做合法性認證,只有認證通過的請求才會允許推送。
認證的方法包括token認證和第三方認證。
token認證,就是為每個直播流配置一個認證碼(token),推流終端只有獲得該認證碼,並將該認證碼作為推流請求的參數提交,才能夠正常推送直播流。
第三方認證,就是將認證請求轉交給第三方系統的服務接口去認證,認證通過後才允許推送直播流。開啟第三方認證後,所有本地認證策略會被忽略。
請求
authMgr/?request=open_pub_auth&application=liveshow
響應
{
"code":0
}
- 9.2.關閉推流認證
用途
針對某個應用,關閉推流認證。關閉後向該應用推送視頻流不需要做認證。
請求
authMgr/?request=close_pub_auth&application=liveshow
application 應用名
響應
{
"code":0
}
- 9.3.查詢推流token
用途
查詢某個應用下推流認證token的列表。
請求
authMgr/?request=list_pub_token&application=liveshow
application 應用名
響應
{ "code":0, "data":{ "count":1, "items":[ { "application":"liveshow", "stream":"live1", "token":"9501E93993FC4D14", "use_once":0 } ] } }
items元素包含當前應用下的token定義。
application 應用名
stream 流名稱
token token值
- 9.4.添加推流token
用途
為視頻流添加推流認證token。
請求
authMgr/?request=add_pub_token&application=liveshow&stream=live1&token_val=9501E93993FC4D14
application 應用名
stream 流名稱
token_val 添加的token值(註意這裏使用token_val參數名,避免與接口認證的token參數沖突)
響應
{ "code":0 }
- 9.5.刪除推流token
用途
刪除某個視頻流的推流認證token。
請求
authMgr/?request=delete_pub_token&application=liveshow&stream=live1
application 應用名
stream 流名稱
響應
{
"code":0
}
- 9.6.設置第三方推流認證地址
用途
將某個應用下的推流認證地址設置為一個第三方認證地址。
設置第三方認證地址後,所有本地認證策略失效。
如果要取消第三方認證,將url參數設置為空即可。
請求
authMgr/?request=set_pub_auth_url&application=liveshow&url=http://i.ruiboyun.net/interface
application 應用名
url 第三方認證接口的url地址,本參數需要進行【URL編碼】。
響應
{
"code":0
}
接口規範 推流認證相關接口