Aruba Central API

How do I access the API gateway?

To access the API Application Programming Interface. Refers to a set of functions, procedures, protocols, and tools that enable users to build application software. Gateway from the Aruba Central UI:

  1. In the Aruba Central app, set the filter to Global.
  2. Under Maintain, click Organization > Platform Integration.
  3. Under the API Gateway tile, click Rest API.
    The API Gateway page is displayed.

The API Gateway portal allows you to run or test any API from portal UI itself. You can try different APIs and see their output before you decide on the API to use in your applications. To run an API, you will require an access token. You can obtain this access token from the Aruba Central UI.

Where can I find a complete list of APIs that Aruba Central offers?

To view the complete list of APIs, complete the following steps:

  1. In the Aruba Central app, set the filter to Global.

  2. Under Maintain, click Organization > Platform Integration > Rest API.
    The API Gateway page with the list of published APIs is displayed.
  3. To view the Swagger interface, click the link in the Documentation column next to the specific published API name. The documentation is displayed in a new window.

Why can't I find the Aruba Central APIs from a Google search?

For security reasons, Aruba Central APIs can be accessed only from the API Gateway which is a private API endpoint. To access API Gateway from the Aruba Central UI, go to Maintain > Organization > Platform Integration > Rest API. Clicking on API link in the Documentation column takes you to the API Gateway portal from where you can access all the APIs that Aruba Central offers.

What is Swagger? How is it related to Aruba Central APIs and API Gateway?

Swagger is an open-source software framework that helps developers document and consume RESTful APIs. The API Gateway documents and publishes Aruba Central APIs using the swagger open source framework.

For more information on Swagger, see https://swagger.io/

How do I get started with APIs? What are the high-level steps?

To get started with the APIs:

  1. In the Aruba Central app, set the filter to Global.
  2. Under Maintain, click Organization > Platform Integration > Rest API.
    The API Gateway page with the list of published APIs is displayed.
  3. Click My Apps & Tokens tab.
  4. Generate an access token.
  5. Click the API Gateway link. The API Gateway portal opens.
  6. From the URL drop-down, select the API category.
  7. In the Token field, enter the access token.
  8. Select the API.
  9. Provide the required parameters.
  10. Click Try.

For more information and step-by-step instructions on getting started with APIs, see the API Gateway.

What is an access token? How do I generate an access token from the Aruba Central UI?

An access token is a string or a credential that identifies a user. To make an API request, the users must obtain an access token.

To generate an access token:

  1. In the Aruba Central app, set the filter to Global.
  2. Under Maintain, click Organization > Platform Integration > Rest API.
    The API Gateway page with the list of published APIs is displayed.
  3. To create an access token, click + Add Apps & Token. The New Token pop-up window opens.
  4. Select the application from the Application drop-down list and click Generate. An access token is created and listed in the Token List table.
  5. Click Download Token to get access token details. The token details are displayed.
  6. Note the refresh token. Access tokens expire in two hours. The refresh token can be used for refreshing the access token.

How long is the access token valid?

An access token is valid for two hours.

Can I change or extend the validity of the token?

No. The validity period for access tokens is fixed and not customizable.

My access token has expired. How do I renew it?

Access tokens are valid for a short time. You can refresh the access tokens using the refresh token string. To view the refresh token, click Download Token on the My Apps & Tokens page. The refresh token is valid for 14 days.

What are the primary things that I need to have for automating workflows using APIs?

You would need an access token and link to the API Gateway.

Can I automate device provisioning using APIs?

Yes, you can automate the entire device onboarding workflow using APIs.

Device onboarding includes the following steps:

  • Assigning subscriptions to the devices in your inventory—Use the APIs under the Licensing category.
  • Creating groups—Use the Groups APIs under the Configuration category.
  • Assigning devices to groups—Use the Devices APIs the Configuration category.

Are all the parameters listed for an API mandatory?

No, only the parameters marked as required are mandatory for an API.

Where can I find the sample request body?

When you select an API in the API Gateway portal, the panel on the right displays the sample request body.

Where can I find the sample response body?

When you select an API in the API Gateway portal, the right panel displays the sample response body. To view the structure of the response, click Response Schema.

Where can I find the documentation for the APIs?

The API documentation is available for the APIs on the API Gateway portal. When you select an API under a subcategory, the middle panel on the page shows the selected API and its description.

For generic information on how to get started with the APIs, API Gateway, and Webhook APIs, see the following documents: