Interface description
Video query
(1) Documents across days
For example, search for 20241207 files, there may be two kinds of video
A. return the video from 2024-12-07 23:00:00 to 2024-12-08 01:00:00, where the value of the day field returned is 12;
B. Return 2024-12-08 23:00:00 to 2024-12-09 01:00:00, where the returned day field value is 13
API address
https://v7.cmsv8.com/StandardApiAction_getVideoFileInfo.action?DevIDNO=013300000001&LOC=2&CHN=0&YEAR=2024&MON=12&DAY=7&RECTYPE=- 1&FILEATTR=2&BEG=0&END=86399&ARM1=0&ARM2=0&RES=0&STREAM=0&STORE=0&jsession=66d754dd7f41473dbd2
Request parameters
| Parameter name | Parameter type | Must | Example | Parameter meaning |
|---|---|---|---|---|
| jsession | string | Yes | 66d754dd7f41473dbd2 | Session number |
| DevIDNO | string | Yes | 01330000001 | the device number, when querying the video on the server, it means the license plate number |
| LOC | number | Yes | 1 | Search location 1 represents a terminal device, 2 represents a storage server, and 4 represents a download server. |
| CHN | number | is | 0 | Search channels (starting from 0) 0 means channel 1,1 means channel 2, and - 1 means all channels. |
| YEAR | string | Yes | 2024 | Search year |
| MON | string | Yes | 12 | Search month |
| DAY | string | Yes | 7 | Search date |
| RECTYPE | number | Yes | 0 | Recording type 0 means regular, 1 means alarm,- 1 means all |
| FILEATTR | number | Yes | 1 | File type 1 means image 2 means video recording. |
| BEG | number | is | 0 | start seconds unit seconds (0 - 86399) |
| END | number | is | 86399 | end seconds unit seconds (0 - 86399) |
| ARM1 | number | Yes | 1 | fill in 0 for non - 1078 equipment alarm ID 1, decimal integer corresponding to binary, binary digit alarm 1 Emergency alarm 2 Overspeed alarm 3 Fatigue driving 4 Warning 5GNSS module failure 6GNSS module is not connected or cut off 7GNSS antenna short circuit 8 terminal main power supply undervoltage 9 terminal main power supply failure 10 terminal LCD or display failure 11TTS module failure 12 camera failure 19 cumulative driving timeout 20 overtime parking 21 access area 22 access route alarm 23 route driving time insufficient/too long 24 route deviation alarm 25 vehicle VSS failure 26 vehicle oil quantity abnormal 27 vehicle theft alarm 28 vehicle illegal ignition alarm 29 vehicle illegal displacement alarm 30 collision rollover alarm |
| ARM2 | number | Yes | 1 | fill in 0 for non - 1078 equipment alarm ID 2, decimal integer corresponding to binary, binary digit alarm 1 video signal loss alarm 2 video signal blocking alarm 3 storage unit fault alarm 4 other video equipment fault alarm 5 bus overcrowded alarm 6 abnormal driving behavior alarm 7 special alarm video reaches the storage threshold alarm |
| RES | number | Yes | 1 | fill in 0 for non - 1078 equipment media type 0: audio and video, 1: audio, 2: video, 3: video or audio and video |
| STREAM | number | Yes | 0 | fill in 0 for non - 1078 equipment code stream type - 1: main or sub- code stream, 0: main code stream, 1: sub- code stream |
| STORE | number | Yes | 1 | fill in 0 for non - 1078 equipment storage type 0: primary or disaster recovery memory, 1: primary memory, 2: disaster recovery memory |
| LABEL | string | No | 1111 | Tags |
Return parameters
| Parameter Name | parameter Type | meaning of parameters | |
|---|---|---|---|
| result | number | interface status code, 0 is normal, and other information is abnormal. For more information, see [Error Code Description](/helpCenter/doc/index.html?isStudy = 1 & pageType = 3 & docId = 1321 & type = 1 "Error Code Description"). | |
| cmsserver | number | ||
| files | array | file Information | |
| arm | number | the alarm information is valid when the alarm is recorded. When loc = = 1, status bit analysis alarm: bit0: emergency button alarm, bit1: overspeed alarm, bit2: low speed alarm, bit3: vibration alarm, bit4: temperature alarm, bit5: motion detection alarm, bit6:UPS wire cutting alarm, bit7: collision rollover alarm, bit8: fatigue driving alarm, bit9:IO_1,bit10:IO_2,bit11: bit11: IO_5,bit14:IO_6,bit15:IO_7,bit16:IO_8; loc! = 1, the value of (arm & 0xFFFF) gets the alarm type. 2: emergency button alarm, 11: overspeed alarm, 3: vibration alarm, 9: temperature alarm, 15: motion detection alarm, 49: fatigue driving alarm, 19:IO_1,20:IO_2,21:IO_3,22:IO_4,23:IO_5,24:IO_6,25:IO_7,26:IO_8; | |
| arm1 | number | 1078 device returns alarm identification 1, the decimal integer corresponding to binary, binary digit alarm 1 emergency alarm 2 overspeed alarm 3 fatigue driving 4 early warning 5GNSS module failure 6GNSS module is not connected or cut 7GNSS antenna short circuit 8 terminal main power supply undervoltage 9 terminal main power supply power failure 10 terminal LCD or display failure 11TTS module failure 12 camera failure 19 cumulative driving timeout 20 overtime parking 21 entry and exit area 22 entry and exit route alarm 23 route driving time is insufficient/too long 24 route deviation alarm 25 vehicle VSS failure 26 abnormal fuel volume of vehicles 27 Vehicle theft alarm 28 Vehicle illegal ignition alarm 29 Vehicle illegal displacement alarm 30 Collision rollover alarm | |
| arm2 | number | 1078 equipment return alarm mark 2, decimal integer corresponding to binary, binary digit alarm 1 video signal loss alarm 2 video signal blocking alarm 3 storage unit fault alarm 4 other video equipment fault alarm 5 passenger car overcrowding alarm 6 abnormal driving behavior alarm 7 special alarm video reaching the storage threshold alarm | |
| beg | number | file start time unit seconds, such as 3600=1 point | |
| chn | number | device channel (starting from 0) 0 means channel 1,1 means channel 2 | |
| chnMask | number | channel mask 1 file is valid when storing videos of multiple channels at the same time, which is represented by bit, bit 0 indicates that there is video of channel 1 in the video file, and so on. First judge the chnMask, if chnMask = 0, then parse chn | |
| day | number | day | |
| mulChn | number | if mulChn is not 0, the channel information obtained by mulChn bit- wise value is displayed. If mulChn is 0, it is necessary to judge which channels have video recording information in the current time period. | |
| mulPlay | number | when the mulPlay>0, multi- channel video playback can be performed | |
| devIdno | string | the device number indicates the license plate number when querying the video on the server. | |
| end | number | the end time of the file is in seconds, for example, 7200=2 o'clock, and the end time may be greater than 86400, which indicates that a cross- day situation occurs. | |
| file | string | ||
| len | number | file size (unit: byte) | |
| loc | number | file location 1 represents terminal device, 2 represents storage server, and 4 represents download server | |
| mon | number | month | |
| recing | number | recording 0 means no recording, 1 means recording. | |
| res | number | 1078 device returns media type 0: audio and video, 1: audio, 2: video, 3: video or audio and video | |
| store | number | 1078 device returns storage type 0: primary or disaster recovery storage, 1: primary storage, 2: disaster recovery storage | |
| stream | number | if the value is set to 1, you cannot download files. You can only download files in segments. | |
| svr | number | the server ID is valid when finding the recording on the storage server and the download server. | |
| type | number | video recording type 0 means regular, 1 means alarm. | |
| year | number | when used in the year, add 2000 | |
| mediaType | number | multimedia type 0 means picture, 1 means video | |
| sourceId | number | valid when it is downloaded from the device, indicating the ID in the corresponding task table | |
| label | string | label | |
| DownTaskUrl | string | the URL of the segmented download, the server video return is empty, and the user needs to fill in the parameters: jsession (required) sbtm (default start time) setm (default end time) lab (default is empty) | |
| DownUrl | string | direct download URL,1078 device returns empty, requires user to fill in parameters: jsession (required) SAVENAME (required) | |
| PlaybackUrl | string | remote playback URL, required parameters: jsession (required) PLAYBEG (default start time) PLAYEND (default end time) | |
| PlaybackUrlWs | string | the remote playback Websocket URL is PlaybackUrlWs, and PlaybackUrlWs playback is preferred. PlaybackUrlWs flash is not supported, the user needs to fill in the parameters: jsession (required) PLAYBEG (default start time) PLAYEND (default end time) | |
Return Example
a. Video query
{
"result": 0,
"cmsserver":1,
"files":[
{
"arm": 0
"beg": 31044
"chn": 1
"chnMask": 0
"day": 11
"devIdno": "013300000001"
"end": 32842
"file": "H20100628-083724P2N2P0.264"
"len": 23211837
"loc": 1
"mon": 1
"mulChn": 0
"mulPlay": 0
"recing": 0
"svr": 0
"type": 0
"year": 10
"mediaType": 1
"sourceId": 1
"label": ""
"DownTaskUrl": " https://v7.cmsv8.com/StandardApiAction_addDownloadTask.action?jsession=&did=1235&fbtm=2024-12-07 08:37:24&fetm=2024-12-07 09:07:22&sbtm=2024-12-07 08:37:24&setm=2024-12-07 09:07:22&lab=&fph=H20100628-083724P2N2P0.264&vtp=0&len=23211837&chn=1&dtp=1"
"DownUrl": " https://v7.cmsv8.com:16604/3/5?DownType=3&jsession=&DevIDNO=013300000001&FLENGTH=23211837&FOFFSET=0&MTYPE=1&FPATH=H20100628-083724P2N2P0.264&SAVENAME="
"PlaybackUrl": " https://v7.cmsv8.com:16604/3/5?DownType=5&&jsession=DevIDNO=013300000001&FILELOC=1&FILESVR=0&FILECHN=1&FILEBEG=31044&FILEEND=32842&PLAYIFRM=0&PLAYFILE=H20100628-083724P2N2P0.264&PLAYBEG=31044&PLAYEND=32842&PLAYCHN=0"
"PlaybackUrlWs": "ws://v7.cmsv8.com:16604/3/5?DownType=5&&jsession=DevIDNO=013300000001&FILELOC=1&FILESVR=0&FILECHN=1&FILEBEG=31044&FILEEND=32842&PLAYIFRM=0&PLAYFILE=H20100628-083724P2N2P0.264&PLAYBEG=31044&PLAYEND=32842&PLAYCHN=0"
}
]
}
B. 1078 video query
{
"result": 0,
"cmsserver":1,
"files":[
{
"arm": 0
"arm1": 0
"arm2": 0
"beg": 31044
"chn": 1
"chnMask": 0
"day": 11
"mulChn": 0
"mulPlay": 0
"devIdno": "500000"
"end": 32842
"file": "H20100628-083724P2N2P0.264"
"len": 23211837
"loc": 1
"mon": 1
"recing": 0
"res": 0
"store": 0
"stream": -1
"svr": 0
"type": 0
"year": 10
"mediaType": 1
"sourceId": 1
"label": ""
"DownTaskUrl": "https://v7.cmsv8.com/StandardApiAction_addDownloadTask.action?jsession=&did=013300000001&fbtm=2024-12-07 08:37:24&fetm=2024-12-07 09:07:22&sbtm=2024-12-07 08:37:24&setm=2024-12-07 09:07:22&lab=&fph=H20100628-083724P2N2P0.264&vtp=0&len=23211837&chn=1&dtp=1"
"DownUrl": ""
"PlaybackUrl": "https://v7.cmsv8.com:16604/3/5?DownType=5&jsession=&DevIDNO=013300000001&FILELOC=1&FILESVR=0&FILECHN=1&FILEBEG=31044&FILEEND=32842&PLAYIFRM=0&PLAYFILE=H20100628-083724P2N2P0.264&PLAYBEG=31044&PLAYEND=32842&PLAYCHN=0"
"PlaybackUrlWs": "ws://v7.cmsv8.com:16604/3/5?DownType=5&&jsession=DevIDNO=013300000001&FILELOC=1&FILESVR=0&FILECHN=1&FILEBEG=31044&FILEEND=32842&PLAYIFRM=0&PLAYFILE=H20100628-083724P2N2P0.264&PLAYBEG=31044&PLAYEND=32842&PLAYCHN=0"
}
]
}
