智慧農業監控攝像頭直播開放接口調用對接
為了滿足智慧農業使用攝像頭直播業務需求，我公司擬定發布基于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 | 超過并發數或者欠費 |