Introduction
Big Network provides a REST API for developers to program Cloud Networks and Edge Devices in their own applications and automation frameworks. This article will guide you through the process of making API requests and provide some helpful tips for getting the most out of Big Network's API.
API Key Management
Big Network supports full API Key lifecycle management via our Portal.
Obtaining an API Key
Before making any API requests, you need to obtain an API key from Big Network. To get an API key, navigate to the Big Network Portal at https://portal.bignetwork.com/. Navigate to the Organization for which you are seeking API access.
Go to Organization -> API.
Click on "Generate" to generate your API Key.
Store your API Key in a secure location. Do not share your API key.
Rotating an API Key
Once you have generated an API Key, you can rotate the API Key (if lost, stolen, or compromised) by using the "Generate New API Key" button.
Revoking an API Key
Once you have generated an API Key, you can revoke the API Key (if lost, stolen, compromised, or you simply no longer with to use the API) by using the "Remove Access" button.
Scope of API Keys
The same permissions apply to generated API key as you have on the current account you used to generate it. Changing your account permissions by organization administrators will result in change of this key permissions. API Keys are unique to the intersection of a user paired with an organization.
Making API Requests
Big Network's API is a RESTful API and supports multiple request types (GET, POST, PATCH, DELETE). The API uses HTTP status codes to indicate success or failure of a request, with a 2xx status code indicating a successful request and a 4xx or 5xx status code indicating an error.
- API Key Header: Include the following header to every request in order to authenticate and authorize: "api-key: << generated key >>"
- Endpoint: the specific endpoint you are trying to access (e.g. /v1/organizations, /v1/organization/{orgID}/networks, /v1/organization/{orgID}/edge-devices/, etc.)
- Query parameters: any additional parameters you want to pass in your request (e.g. search terms, date range)
API Specification
For information on how to use Big Network's API, including information on available endpoints, query parameters, and response formats, please refer to the Big Network OpenAPI Specification at
https://public-api.bignetwork.com/api-docs/.Rate Limiting
Big Network's API has rate limiting in place to prevent excessive usage and ensure the stability of its systems. If you exceed the rate limit, your API key may be temporarily suspended.
Error Handling
In the event of an error, the API will return a 4xx or 5xx HTTP status code, along with a descriptive error message. It is important to handle these errors in your code to ensure a smooth user experience.
Prototyping and Testing API Requests
To help familiarize yourself with API, you can send requests directly from
https://public-api.bignetwork.com/api-docs/. Simply
click on the "Authorize" button, insert your api-key and then use "Try it out" button on each request.
Related Articles
Big Network Technology Overview
Introduction Big Network is a cloud managed connectivity platform that securely and instantly connects people, places, clouds and their devices anywhere. Big Network provides hardware, software and cloud services in one platform creating an open and ...
Deploy Static IP Anywhere by Big Network
Introduction Static IP Anywhere (SIPA) by Big Network is the ideal solution for delivering Static IP addresses via multiple resilient ISP connections without the cost and complexity of BGP routing, expensive enterprise dedicated internet access, or ...
Edge Pro On-Boarding Guide
Introduction This guide is designed to assist with the Edge Pro on-boarding process. Assumptions Device Model: IEI Puzzle Facility Requirements: Available Internet access service with DHCP WAN addressing (see below for Static WAN IP) Existing Big ...
Edge Lite On-Boarding Guide
Introduction This guide is designed to assist with the Edge Lite on-boarding process. Assumptions Device Model: Edge Lite Facility Requirements: Available Internet access service with DHCP WAN addressing (see below for Static WAN IP) Existing Big ...
Build Your Big Network - Your Edge Demo
Summary Big Network offers Edge Lite and Edge Pro trial hardware to prospective customers, free of charge, in exchange for product feedback (called a "Demo"). If you are interested in participating the program, please see the terms and conditions ...