数据提取 API

简介

本节 explains how to extract data from the Gear Studio platform 使用 HTTP API, such as:

• 提醒: the API allows extracting the definition of all alerts created in the platform, filtering them in different ways.
• 警报: the API allows extracting all alarms recorded in the platform, historically, filtering them in different ways.
• 端点 data: the API allows extracting all information associated with endpoints, historically, filtering it in different ways.
• 地理围栏: the API allows extracting the list of geozones configured for each client, including the list of vehicles contained within them.

Getting Started

Creating an 访问令牌

As with any other HTTP integration, it is necessary to create an 访问令牌. 本页面 contains more information about managing 访问令牌s. Access tokens allow controlling the access and permissions used for any operation.

Authentication using an 访问令牌

In all APIs, the 访问令牌 can be sent as part of the header, using an Authorization header, as shown 下方:

Authorization: Bearer e54e0911-ece3-4b7a-b84d-afc01dfa81f1

Alternatively, when it is not possible to send the token through the Authorization header, the 访问令牌 can be sent as part of the URL, through the "accessToken" parameter, as in the following example:

https://gear.cloud.studio/api/v2/alarms?accessToken=e54e0911-ece3-4b7a-b84d-afc01dfa81f1&clientID=4&maxCount=10

API Execution

To execute the API, review each of the following sections, which contain the related information:

• Extracting alerts.
• Extracting alarms.
• Extracting endpoint data.
• Extracting geozone data.