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