? ? 為了滿足各行業用戶使用監控直播業務需求，我公司擬定發布基于WEB方式，M3U8視頻調用對接接口如下，前端需要部署我們智能網關，然后推流到我們云平臺，支持市場主流監控攝像頭廠商的接入，歡迎大家咨詢交流，視頻對接API開發包，請與我公司業務人員索取。
監控直播開放接口文檔 1
一、 概述 2
二、 API接口 2
2.1 獲取設備列表 2
2.2 監看請求 3
三、 代碼對照表 4
3.1 命令碼 cmdID 4
3.2 響應碼 result 4
一、概述
- 二、API接口
- 二.1 獲取設備列表
|
名稱 |
獲取設備列表 |
請求方式 |
GET | POST |
|
|
URL |
(http|https)://cdn88.cn/api/ |
|||
|
功能描述 |
獲取用戶賬號下設備列表：播放地址、縮略圖、名稱、SN |
|||
|
請求參數 |
類型 |
默認值 |
必填 |
參數說明 |
|
cmdId |
number |
100 |
是 |
指令代碼，未指定則默認100 |
|
ip |
string |
? |
? |
服務器ip，非自建服務器請留空 |
|
user |
string |
? |
是 |
登錄賬號 |
|
password |
string |
‘’ |
? |
登錄密碼(支持MD5)，默認空密碼 |
|
dev |
string |
null |
? |
設備SN，默認返回賬號下所有設備，指定設備則用逗號隔開SN |
|
返回參數 |
類型 |
默認值 |
必填 |
參數說明 |
|
cmdId |
number |
101 |
是 |
指令代碼 |
|
result |
number |
? |
是 |
0正常，其它異常狀態參考代碼對照表result |
|
devlist |
array |
? |
? |
result=0時返回，[{},{},...] |
|
+ip |
string |
? |
? |
設備連接的流媒體服務器ip |
|
+sn |
number |
? |
? |
設備序列號SN |
|
+port |
number |
? |
? |
協議端口 |
|
+flsPort |
number |
? |
? |
FLASH方式播放端口 |
|
+devid |
number |
? |
? |
設備ID |
|
+name |
string |
? |
? |
設備名稱 |
|
+hlsurl |
string |
? |
? |
hls播放地址 |
|
+imgsrc |
string |
? |
? |
縮略圖地址 |
|
+state |
number |
? |
? |
設備狀態，0=正常，其它異常參考代碼對照表result |
-
- 二.2 監看請求
? 首次請求后，如果該視頻未被其他人播放過，則可能需要10秒左右準備視頻文件，此時播放地址可能暫時失效，需要業務里設置重新加載的邏輯；
? 之后每5分鐘保持一次請求，否則會停止生成視頻文件，播放地址失效
|
名稱 |
監看請求 |
請求方式 |
GET | POST |
|
|
URL |
(http|https)://cdn88.cn/api/ |
|||
|
功能描述 |
通知服務器準備播放所需的視頻文件 |
|||
|
請求參數 |
類型 |
默認值 |
必填 |
參數說明 |
|
cmdId |
number |
200 |
是 |
指令代碼 |
|
ip |
string |
? |
? |
服務器ip，非自建服務器請留空 |
|
user |
string |
? |
是 |
登錄賬號 |
|
password |
string |
‘’ |
? |
登錄密碼(支持MD5)，默認空密碼 |
|
dev |
string |
? |
是 |
監看設備的SN |
|
返回參數 |
類型 |
默認值 |
必填 |
參數說明 |
|
cmdId |
number |
201 |
是 |
指令代碼 |
|
result |
number |
? |
是 |
0正常，其它異常狀態參考代碼對照表result |
更新于：2019年09月
-
- 三、代碼對照表
- 三.1 命令碼 cmdID
100-199 登錄驗證相關協議
200-499 媒體控制相關協議
500-999 設備控制相關協議
|
cmdID |
說明 |
|
100 |
登錄驗證 |
|
101 |
登錄驗證 - 返回 |
|
110 |
登錄驗證 - 多通道版 |
|
111 |
登錄驗證 - 多通道版 - 返回 |
|
200 |
監看請求 |
|
201 |
監看請求 - 返回 |
|
202 |
監看請求 - 多設備免登錄 |
|
210 |
監看請求 - 多通道 |
|
300 |
云臺控制指令 |
|
500 |
設備重啟 |
|
501 |
獲取設備狀態 |
|
502 |
獲取設備狀態 - 返回 |
|
503 |
獲取設備端配置 |
|
504 |
獲取設備端配置 - 返回 |
|
506 |
更新設備端配置 |
-
- 三.2 響應碼 result
|
result |
說明 |
|
0 |
成功 |
|
-1 |
其它錯誤 |
|
9 |
沒有這個用戶 |
|
10 |
用戶已經在線 |
|
11 |
用戶密碼錯誤 |
|
50 |
設備不在線 |
|
57 |
請求被拒絕,設備未驗證 |
|
73 |
轉發服務器不在線 |
|
77 |
不在定時監看范圍內 |
|
1019 |
超過并發數或者欠費 |
?