dashboard-api-go

dashboard-api-go is a Go client library for the Meraki Dashboard API.

Usage

import meraki "github.com/meraki/dashboard-api-go/sdk"

Introduction

The dashboard-api-go makes it easier to work with the Meraki Dashboard RESTFul APIs from Go.

It supports version 1.33.0

Getting started

The first thing you need to do is to generate an API client. There are two options to do it:

1. Parameters
2. Environment variables

Parameters

The client could be generated with the following parameters:

• baseURL: The base URL, FQDN or IP, of the MERAKI instance.
• dashboardApiKey: The meraki_key for access to API.
• debug: Boolean to enable debugging
• userAgent: String, set the User-Agent Format (AplicationName VendorName).

client, err = meraki.NewClientWithOptions("https://api.meraki.com/",
		"MerakiKey",
		"true", "AplicationName VendorName Client")
	if err != nil {
		fmt.Println(err)
		return
	}
nResponse, _, err := client.Administered.GetAdministeredIDentitiesMe()
	if err != nil {
		fmt.Println(err)
		return
	}

Fetch All Items of an Endpoint with Pagination

• Support for fetching all items with perpage=-1
  A new feature has been introduced to the API endpoints, enabling clients to fetch all available items in a single request by setting the perpage parameter to -1. This enhancement allows you to retrieve the full dataset without needing to make multiple paginated requests.

Behavior

• When perpage is set to -1, the server will return all available items for that endpoint, bypassing the pagination logic.
• If a positive integer is passed for perpage, the endpoint will continue using traditional pagination and return only the number of items specified by perpage.

Example Usage

func main() {
	var err error
	fmt.Println("Authenticating")
	client, err = meraki.NewClient()
	if err != nil {
		fmt.Println(err)
		return
	}

	nResponse, _, err := client.Organizations.GetOrganizationDevices("828099381482762270", &meraki.GetOrganizationDevicesQueryParams{
		PerPage:        -1,
		TagsFilterType: "withAnyTags",
	})
	if err != nil {
		fmt.Println(err)
		return
	}
	if nResponse != nil {
		fmt.Println("\n <Count>: ", len(*nResponse))
		fmt.Printf("%v", *nResponse)
		return
	}

	fmt.Println("There's no data on response")

Fetch All Items

To retrieve all items from the endpoint, set the perpage parameter to -1:

Using environment variables

The client can be configured with the following environment variables:

• MERAKI_BASE_URL: The base URL, FQDN or IP, of the MERAKI instance.
• MERAKI_DASHBOARD_API_KEY: The meraki_key for access to API.
• MERAKI_DEBUG: Boolean to enable debugging
• MERAKI_USER_AGENT: String, set the User-Agent Format (AplicationName VendorName Client).

Client, err = meraki.NewClient()
devicesCount, _, err := Client.Devices.GetDeviceCount()

Examples

Here is an example of how we can generate a client, get a device count and then a list of devices filtering them using query params.

client, err = meraki.NewClientWithOptions("https://api.meraki.com/",
		"MerakiKey",
		"true", "AplicationName VendorName Client")
	if err != nil {
		fmt.Println(err)
		return
	}

	nResponse, _, err := client.Organizations.GetOrganizations()
	if err != nil {
		fmt.Println(err)
		return
	}
	if nResponse != nil {
		fmt.Println(nResponse)
		return
	}
	fmt.Println("There's no data on response")

Documentation

dashboard-api-go

Compatibility matrix

SDK versions	MERAKI Dashboard version supported
2.y.z	1.33.0
3.y.z	1.44.1
4.y.z	1.53.0

Changelog

All notable changes to this project will be documented in the CHANGELOG file.

The development team may make additional name changes as the library evolves with the MERAKI Dashboard APIs.

License

This library is distributed under the MIT license found in the LICENSE file.