September 2018

API Enhancements

New API Endpoints

 Display the splash page settings for the given SSID

 Modify the splash page settings for the given SSID

 List the syslog servers for a network

 Update the syslog servers for a network

 Return a video link for the specified camera

Enhancements

 Return the inventory for an organization

  • Now includes device name in JSON array:
    • [
        {
          "mac": "00:11:22:33:44:55",
          "serial": "Q234-ABCD-5678",
          "networkId": "N_24329156",
          "model": "MR34",
          "claimedAt": 1518365681.0,
          "publicIp": "123.123.123.1",
          "name": "My AP"
        }
      ]

As always, please see the Postman Collection for more details on these and all Dashboard API endpoints.

 

 

July 2018

API Feature Improvements

Poll additional client statistics

The Dashboard API now allows you to poll for client statistics, including the client usage and statistics like traffic and latency history as well as security events. For the full list of Client endpoints, please visit the Meraki Postman collection.

Meraki authentication users and login attempts

Poll for:

  • Authentication attempts against the Meraki authentication server via traditional cloud RADIUS or splash page
  • Splash page login attempts

Bluetooth clients

Poll for all the Bluetooth clients seen by the access points in a Meraki network.

As always, please see the Postman Collection for more details on these and all Dashboard API endpoints.

New Solution Guides & Demos

Meraki Dashboard Reports with Google Sheets

Easily import Meraki Network data into Google Sheets using the Meraki Dashboard API. This tool allows administrators to create reports for a single network, organization or across multiple networks or orgs. Built into the tool is reporting for:

  • Organizations by API key
  • Organizations
  • Device Inventory
  • Networks
  • Devices
  • License State
  • Configuration Templates
  • Group Policies
  • SSIDs
  • VLANs

The source code and a clone-able demo is available here.

Captive Portal with Mews Hospitality PMS

Integrate a wireless network with a hotel PMS system, using the Meraki and Mews APIs. This guide serves as an example of what could easily be built when you have the power of cloud networking on your side.

May 2018

API Feature Improvements

Configure your Meraki network for compliance with GDPR regulations (EMEA only)

For Organizations hosted in the EMEA region, the Dashboard API now supports PII (Personally Identifiable Information) endpoints for GDPR compliance. More information is available here and the Postman collection has also been updated.

New Solution Guides & Demos

Create Custom Analytics Dashboards with Meraki and Splunk

Splunk can collect data from a Meraki network using the Scanning API to collect location data for Wi-Fi and bluetooth devices and using Syslog to collect syslog events for the MX security appliance. This integration guide and live demo shows the potential for what is possible with Splunk and Meraki.

Create Meraki Networks with ServiceNow and Angular

Explore a scenario in which a service provider would like to provide a custom Meraki tool where their operators can easily provision a network. The tool supports site details, binding a newly created network to a template and adding devices. The results are stored in a database table for use with other ServiceNow services.

Manage Administrators with the Meraki Puppet Module

The new Cisco Meraki module for Puppet lets you define Meraki organization administrators across all of your networks and across multiple organizations, a task that can be tedious for large IT organizations with complex permissions such as service providers or large IT organizations.

Configure your Meraki Network to Support Yelp WiFi

This guide will walk you through the process of creating a Meraki Network configured to support Yelp WiFi. Once you have a Network created, you will be able to add access points and begin using them to create your Yelp WiFi hotspots.

April 2018

API Feature Improvements

List the status of every Meraki device in the entire Organization

Our Dashboard API has been updated to allow users to pull Meraki node statuses for the entire Organization in one API call and in one JSON blob. This removes the requirement to make many (sometimes thousands) of API calls to retrieve this information, reducing overhead and restrictions from the API rate limit.

This call returns the following attributes in array format:

Further documentation is available in the Postman Collection.

New Solution Guides & Demos

Wayfinding with Meraki and Mapwize

Individuals often have a hard time finding their way indoors, as services like Google Maps don’t generally provide guidance. Mapwize’s indoor mapping platform allows you to use Meraki access points to navigate buildings like shopping malls, hospitals and more. This article will teach you how to create a custom map with Mapwize’s open-source platform and deploy it alongside Meraki access points and the Scanning API.

Investigo – Spark Bot with Meraki Scanning API [DEMO]

Investigo is a bot for Spark, Cisco’s unified communications service, which enables customers to use wireless infrastructure to locate Wi-Fi capable assets. The Investigo is a mash-up bot that uses several solutions: Spark, Tropo and Meraki wireless access points, spanning from the enterprise to the Internet of Things world.

What’s a “Deep Link?”

Learn about how to use deep links to navigate directly to a single client device, Meraki node, or switch port in the Dashboard via your existing system. These deep links can be constructed and accessed as long as a user is logged into Dashboard and can be injected to reduce the number of clicks a network operator needs to perform to reach the page he/she is looking for.

March 2018

API Feature Improvements

Clone Network via API

Our Dashboard API has been updated to allow for users to copy the initial configuration from an existing network when creating a network via API. This is done via the new parameter, ‘copyFromNetworkId’.

This functions in the exact same way as the existing ‘Clone from existing network‘ option on the Create Network page in Dashboard. More information can be found on our API documentation. This new endpoint is updated in the Postman Collection.

MX Cellular Firewall Rules

This new endpoint allows you to return existing MX Cellular firewall rules as well as update those rules. Documentation is available in the Postman Collection.

New Solution Guides & Demos

Manage Administrators Across Organizations

Meraki users may encounter a scenario where they must manage multiple Meraki dashboard organizations, whether by necessity (scale) or for management purposes. A powerful Python script has been developed by our open source community in order to help our users quickly and programmatically add, delete, find, and list administrators across organizations.

Node-RED and Meraki APIs Demo

Interacting with APIs, the Internet of Things and building automation tools has never been so easy and fun. Node-RED is an open source flow based editor built on NodeJS. If you are new to developing or would like a “low-code” experience for using Meraki APIs, this tool is perfect for you.

Updates Archive

API Feature Improvements

DNS Settings now in the API

API Users can now configure DNS nameservers through our Dashboard API. The dnsNameservers parameter can be “upstream_dns”, “google_dns”, “opendns”, or a newline separated string of IP addresses or domain names. Remember to add a n separation between each of the values enclosed in quotes with no spaces.

In curl this will would look like:

curl -X PUT -H "X-Cisco-Meraki-API-Key: <<redacted>>" -H "Content-Type: application/json" -H "Cache-Control: no-cache" -d 
' {
      "dnsNameservers"  :   "8.8.4.4n1.2.3.4n8.44.4.2n1.22.3.4n11.1.1.3n11.111.1.1n111.22.11.33"
  } ' 
"https://dashboard.meraki.com/api/v0/networks/L_11112222333444/vlans/1"

Air Marshal WIPS added to API

Air Marshal scan results are now available via the Dashboard API. This enables separate applications to monitor for rogue and neighboring access points.

image

Documentation is available in the Postman Collection.

Updates for February 2017

RADIUS Feature Improvements

Walled Garden added to API

The SSID Settings API endpoint now supports setting the Walled Garden and Per Client Bandwidth Limits. See the API documentation page or make an API call to get your SSIDs.

 

Meraki Cloud-based RADIUS Proxy launched

All customers will now be able to proxy RADIUS requests through the Meraki backend to their RADIUS servers. This allows your network to have all of your RADIUS packets coming from one destination (the Meraki Cloud) rather than many different destinations from many Access Points. This also reduces the firewall rules required at each site for large deployments.

To see this feature go to Wireless > Access Control, and configure a network with WPA2-Enterprise with my RADIUS server and you should now see the option to use the proxy just below the RADIUS server settings.

image

Updates for January 2017

API Feature Improvements

Walled Garden added to API

The SSID Settings API endpoint now supports setting the Walled Garden and Per Client Bandwidth Limits. See the API documentation page or make an API call to get your SSIDs.

 

Create combined networks with the Dashboard API

We added the ability to create combined networks from the create network endpoint in the provisioning API. You can specify a space-separated list of network types to create a combined network. All of the network types that currently be created via the API (wireless, switch, appliance, phone) are accepted.

Read the API documentation here.

Hotspot 2.0 settings API endpoint

There is a new Dashboard API endpoint for returning and updating the Hotspot 2.0 settings for an SSID. An organization must have the ‘has_hotspot_20’ NFO in order to use the endpoint.

Updates for December 2016

API Feature Improvements

New API for L3 Firewall Rules on SSIDs

The Dashboard API has added a new endpoint for reading and writing the L3 firewall rules for an SSID. This feature is available across all MR access points.  Here is a link to the detailed API documentation for the L3 Firewall Rules endpoint.

DHCP Exceptions allow Networks to override their Templates

You can now configure fixed IP assignments and reserved IP ranges on a networks that are bound to a configuration template, on the dashboard at Security Appliance > DHCP. This will override the settings configured on the template. These new overrides allow for unique VLANs at each site. These settings are also available in the Dashboard API.

image

 

Systems Manager API

A new collection of API endpoints for Systems Manager EMM are now released – to all customers. The below screenshot shows the available actions. Due to the large number of SM devices in some networks, the API has a unique ability to filter the devices impacted rather than apply to all devices. Users can filter devices by a set of identifiers (id / serial / wifi mac) or by a list of client tags.

Systems Manager

  • Move a set of devices to a new network
  • List the devices enrolled in an SM network with various specified fields and filters
  • Add, delete, or update the tags of a set of devices
  • Modify the fields of a device
  • Lock a set of devices
  • Wipe a device
  • Force check-in a set of devices

 

Static Routes now in the Dashboard API

We now support static route configuration via the Dashboard API. It operates in a very similar manner to the existing VLANs API, and allows for editing name, subnet, gateway IP address, enabled/disabled, fixed IP Assignments, and reserved IP Ranges.

Here is a Link to the dashboard API documentation

 

New Phone endpoints added to Dashboard API

You can now assign contacts, phone numbers and extensions to MC phones using the Dashboard API.

Phone assignments

  • List all phones in a network and their contact assignment
  • Return a phone’s contact assignment
  • Assign a contact and number(s) to a phone
  • Remove a phone assignment (unprovision a phone)

Phone contacts

  • List the phone contacts in a network
  • Add a contact
  • Update a phone contact. Google Directory contacts cannot be modified.
  • Delete a phone contact. Google Directory contacts cannot be removed.

Phone numbers

  • List the available phone numbers in a network
  • List all the phone numbers in a network

Read the API documentation here.

Updates for November 2016

API Feature Improvements

Combined Templates added to API Dashboard API now supports GET for device uplink information

The Meraki dashboard endpoint will now return an array of hashes of information about the device’s uplinks.

 

Example responses – for a switch:

image

For an MX with 2 uplinks:

image

For an MX using cellular:

image

Updates for October 2016

API Feature Improvements

Bluetooth Clients added to the Scanning API

Meraki access points with an integrated Bluetooth Low Energy radio have the ability to transmit BLE Beacons, as well as to detect and locate BLE devices. BLE scanning allows the Meraki AP to listen for and locate all Bluetooth Low Energy devices. The BLE scanning radio in the access point can detect Beacons, BLE asset tags, and devices like fitness monitors that communicate using BLE data protocols.

When combined with a map of access points in dashboard, the CMX Location API will report Bluetooth client locations as devices on a given floorplan. The location API delivers data in real-time from the Meraki cloud and can be used to detect WiFi devices (associated and non-associated) in real-time. This allows third party applications to provide asset tracking and analytics using battery-based bluetooth tags or wearables like fitness monitors. In addition to the API, Bluetooth-enabled devices like smartphones hear a BLE Beacon emitted by the Meraki access point, and an app on the smartphone can detect it’s distance from the access points using Beacon ranging.

 

Bluetooth Low Energy (BLE) Guide

Bluetooth Location API Data Elements:

Name
Format
Description
apMac string MAC address of the observing AP
apTags [string] JSON array of all tags applied to the AP in dashboard
apFloors [string] JSON array of all floorplan names on which this AP appears
clientMac string Device MAC
seenTime ISO 8601 date string Observation time in UTC; example: “1970-01-01T00:00:00Z”
seenEpoch integer Observation time in seconds since the UNIX epoch
rssi integer Device RSSI as seen by AP
location location Device geolocation; null if location could not be determined
lat decimal Device latitude in degrees N of the equator
lng decimal Device longitude in degrees E of the prime meridian
unc decimal Uncertainty in meters
x [decimal] JSON array of x offsets (in meters) from lower-left corner of each floorplan
y [decimal] JSON array of y offsets (in meteres) from lower-left corner of each floorplan

 

 

Updates for September 2016

API Feature Improvements

Dashboard API Launched to all customers

Previously access to the API was enabled by contacting support. Now this option can be found on the Organization > Settings page to allow any customer to enable the API on their own.

The API docs will be available to all users regardless of whether or not access has been enabled for them at https://api.meraki.com/api_docs

If the API has not been enabled, a banner will appear on the API docs page to let the user know.

See the Postman Collection.