New MV API - Returns video link for the specified camera

[GeorgeB]

Returns video link for the specified camera. If a timestamp is supplied, it links to that time. This is useful for programmaticlly retrieving a video link in dashboard.This negates the need to determine the unique camera URL manually and protects applications from any changes we make to the formatting of this link as API will return the updated URL.

HTTP REQUEST

GET /devices/[serial]/cameras/video_link

 

PARAMETERS

• timestamp
  The video link will start at this timestamp. The timestamp is in UNIX Epoch time (milliseconds).

 

SAMPLE REQUEST

curl -L -H 'X-Cisco-Meraki-API-Key: <key>' -H 'Content-Type: application/json' -X GET 'https://api.meraki.com/api/v0/devices/[serial]/cameras/video_link'

SAMPLE RESPONSE

Successful HTTP Status: 200

"https://nxx.meraki.com/office-cameras/n/bs0a1k/manage/nodes/new_list/29048243992402"

[PhilipDAth]

This will be very popular.  People are going to want a way to get this link via the Dashboard as well ...

[MRCUR]

@PhilipDAth It's just the URL of an individual camera page that you can see today. 

[GeorgeB]

This already exists and was added a short while back.

https://xx.meraki.com/xxx-xxxxx-xxxxxx/n/AXdkNdV/manage/nodes/new_list/13803404165546?timespan=86400&timestamp=1536854003108

[DexterLaBora]

Postman Updated!

[Toogii]

hi, Can you please advise how can I retrieve the people counts from camera API?

[NolanHerring]

@Toogii

This is a new feature called MV Sense that should get you what you need. Limited info on all of this so far from what I can tell.

https://meraki.cisco.com/lib/pdf/meraki_datasheet_mv_sense.pdf

https://meraki.cisco.com/blog/2018/11/introducing-mv22-mv72-and-mv-sense/

https://developer.cisco.com/codeexchange/github/repo/CiscoDevNet/Meraki-Camera-Notification

[omer]

Yeah, the firmware that enables Sense (MV 3.22) is still in Beta. 

@Toogii, you could upgrade your cameras' firmware to MV3.22 and go to the Settings page of each camera to enable Sense and set it up with your MQTT broker, or use the REST API.

Everyone with an MV network on their organization got 10 MV Sense licenses for free, so you can try it out without buying any other license for now. Each camera you enable Sense on counts towards those 10 licenses, which means you can use the people-counting API on 10 of your cameras for free.

Take a look at this page as well, it walks you through the setup process, as well as the API calls:

https://documentation.meraki.com/MV/Other_Topics/MV_Sense

[Toogii]

@omer Thank you very much. We are testing with the Meraki cameras now. I have installed the new beta firmware and enabled the sense. But the REST API isn't working. I mean it is working with other endpoints such as return the video link for specified camera. But not working for Sense endpoints. Can you please advise what could be the reason? 

GET https://api.meraki.com/api/v0/devices/[serial]/analytics/overview 

[Toogii]

@NolanHerring Thank you very much. But the API request is not working for the camera analytics. Not for sure why. I upgraded the firmware enabled the sense. Other API requests are working normally. 

[omer]

Just created a pull request for the python module to add this functionality!

[PeterJames]

Hi @GeorgeB,

Sorry I am a bit new to the Meraki camera scene.

A few questions:

1. We can supply the start of the video, but can you set the end time of the video?
2. Do you need credentials to retrieve this video?
3. Can the video file be downloaded?

We have certain events in our customer solutions that we would want a slice of video for.

Thank you,
Peter James

[GeorgeB]

Hey @PeterJames

1. You can only supply the start.

2. Yes, you need valid Dashboard credentials with permissions which would allow you to view that camera and historical video.

3. Not via the API, this must be done in the Dashboard export UI.

[PeterJames]

Thanks @GeorgeB,

I will continue to watch this space!

We have a business need to start recording on one event, stop an another and way to view/store or download just this section of the feed. One of these days I will catch who is messing with my lunch in the fridge at work!

Thank you,
Peter James

[Toogii]

@GeorgeB Can you please advise if 3rd party software vendors can subscribe using REST API to get the live streaming of the selected camera? If this is not available for now, are you planning to enable this in the nearest future, please? 

[TracyMc]

Has any development been made to allow for download via the API?