New MV API - Returns video link for the specified camera

GeorgeB
Meraki Employee

New MV API - Returns video link for the specified camera

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"
15 REPLIES 15
PhilipDAth
Kind of a big deal

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

MRCUR
Kind of a big deal

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

MRCUR | CMNO #12

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

camera_link.png

 

 

 

DexterLaBora
Meraki Employee

Postman Updated!

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

NolanHerring
Kind of a big deal

omer
Conversationalist

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

@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 

 

@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
Conversationalist

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

PeterJames
Head in the Cloud

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

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.

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

@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? 

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

Get notified when there are additional replies to this discussion.
Welcome to the Meraki Community!
To start contributing, simply sign in with your Cisco account. If you don't yet have a Cisco account, you can sign up.