Programmability/API

Getting Started

For more information on programmability or API Application Programming Interface. Refers to a set of functions, procedures, protocols, and tools that enable users to build application software., please review the Developer Hub to learn more information about extensibility features.

What types of Programmable Interfaces are supported ?

REST Representational State Transfer. REST is a simple and stateless architecture that the web services use for providing interoperability between computer systems on the Internet. In a RESTful web service, requests made to the URI of a resource will elicit a response that may be in XML, HTML, JSON or some other defined format. API, Streaming API and Webhooks

• Getting Started with REST API

• Getting Started with Streaming API

• Getting Started with WebHooks

How do I access the HPE Aruba Networking Central API gateway?

To access the HPE Aruba Networking Central API gateway, see HPE Aruba Networking Central API Gateway.

How do I generate an access token?

An API access token can be generated using the following methods:

• API Gateway Web UI - Creating Application & Token

• REST API

What are the API rate limits?

API call limit is dynamic and based on number of subscribed devices in the account. However, the default API rate limit begins at 5000 (per day), 7 calls (per second).

For more information, see the Developer Hub guide under Usage & Rate Limits.

Does HPE Aruba Networking offer tools to test API calls?

HPE Aruba Networking offers two web UI methods to test API calls:

• API Swagger Interface

• API reference guide via Developer Hub

Each method provides required parameters for API endpoint, expected API response and model schema.

Where can I find the API reference list ?

The API reference list can be found using two methods:

• Swagger documentation via HPE Aruba Networking Central UI

  For detailed steps on accessing the API list using Swagger Documentation, see Swagger Documentation.

• HPE Aruba Networking Developer Hub

  For more information, see Central API Reference.

HPE Aruba Networking Central API

How do I access the API gateway?

To access the API Gateway from the HPE Aruba Networking Central UI:

1. In the HPE Aruba Networking 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 HPE Aruba Networking Central UI.

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

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

1. In the HPE Aruba Networking 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 HPE Aruba Networking Central APIs from a Google search?

For security reasons, HPE Aruba Networking Central APIs can be accessed only from the API Gateway which is a private API endpoint. To access API Gateway from the HPE Aruba Networking 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 HPE Aruba Networking Central offers.

What is Swagger? How is it related to HPE Aruba Networking 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 HPE Aruba Networking 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 HPE Aruba Networking 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 HPE Aruba Networking 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 HPE Aruba Networking 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:

• API Gateway
• Webhooks