The Equinix API
Equinix™ provides a RESTful HTTP API which can be reached at https://api.equinix.com/. This document describes the API and how to use it.
The API allows you to programmatically interact with your Equinix resources, including projects, devices, connections, orders, colocation deployments, support tickets, and identity and access management.
Using the Equinix API
Using the API can be broken down into two major steps, the authorization flow, and the request flow.
Interacting with Equinix products over API requires:
- Equinix Customer Portal account.
- Product-specific create, modify and delete permissions. Contact your organization's primary administrator and request access permissions.
The Authorization Flow
-
Register and Authorize an application in the Customer Portal.
-
Request access and refresh token information by calling the Equinix OAuth API (/oauth2/v1/token) with the Consumer key, Consumer secret, and your user credentials.
-
When you make the request to the authorization API, the API gateway makes an OAuth call to the identity provider using the credentials you specify in the call.
-
The identity provider returns the short-lived OAuth access token and its associated refresh token back to you.
For more information and more detailed instructions, see API Authentication.
The Request Flow
-
Using a valid OAuth access token to authorize a request, make a call to an API endpoint with the required authorization header.
-
API gateway validates the request and calls the relevant Equinix API.
-
The response is received by the API gateway.
-
The response is sent back to you.
API References
The Equinix API is organized into versioned functional groups. Each functional group contains a set of API endpoints that allow you to perform operations related to that group.
API references are provided in OpenAPI format which includes detailed information about each endpoint, including the request and response formats, required parameters, and example requests. Throughout the Equinix Product Documentation you will find links to the "API Reference" corresponding with the product or service discussed.
To view a library of all Equinix API References by functional groups, see the API Catalog. You can also find links to all of the Equinix API References using the following navigational tree. Every leading API path is linked to its corresponding API Reference in this view.