Connections
To work with your APIs in Developer Portal, you first need to import them by connecting it to an API Gateway — which can be either Sensedia or third-party.
This connection (or integration) allows the synchronization of your API data with Developer Portal.
The Connections screen, accessible from the left sidebar, allows you to configure new connections. You can also view, edit, or delete existing connections.
See below:
-
The steps to:
-
The detailed description of each field on the screens of:
-
connection details:
-
import details:
Creating a new connection
Follow the steps below to create a new connection.
For AWS gateways: to create a connection ensure you have an AWS connection user for your AWS Gateway and have obtained your credentials. |
In connections with the Sensedia API Manager, the APIs are imported automatically. See how to import APIs when integrating with AWS API Gateways. |
Connections Listing
Existing connections are listed on the Connections screen.
For each connection (row), the following information (columns) is displayed:
-
PROVIDER:
-
for Sensedia gateways or
-
for AWS gateways.
-
-
NAME: connection’s identifier.
-
MODE: connection mode, which can be NATIVE or NON-NATIVE.
-
STATUS: synchronization status of API data:
-
DONE, indicating that the data synchronization was successfully completed;
-
IN PROGRESS, indicating that synchronization is in progress;
-
FAILED, indicating that the synchronization of one or more APIs has failed;
-
SYNC NOT STARTED, indicating that the synchronization process has not started yet;
-
NO IMPORTS, indicating that there are no imported APIs.
-
-
API COUNT: number of imported APIs.
-
LAST SYNC: date and time of the last synchronization.
Additionally, the ACTIONS column provides the following features:
-
: to see general connection information and edit its settings.
-
: to delete a connection
It’s not possible to delete connections with IN PROGRESS and SYNC NOT STARTED statuses. |
You can search for specific connections using the following fields, located above the listing:
-
Name: search by connection name.
-
Provider: search by provider.
-
Status: search by synchronization status.
After filling in the desired fields, click SEARCH.
To clear filled fields, click CLEAR.
To update the results, click .
Connection Details
General Info
To access the screen with connection details, where General Info is located, follow the steps described in the section "Viewing connection details".
![connection details screen with general information panel](_images/integration_general_info.png)
This panel displays the following information about the selected connection:
-
The synchronization status of API data (at the top left corner):
-
DONE, indicating that data synchronization was successfully completed;
-
IN PROGRESS, indicating that synchronization is in progress;
-
FAILED, indicating that synchronization of one or more APIs failed;
-
SYNC NOT STARTED, indicating that the synchronization process has not yet started;
-
NO IMPORTS, indicating that there are no imported APIs.
-
-
Connection Name: name of the connection.
-
Mode: connection mode, can be NATIVE or NON-NATIVE.
-
Created At: creation date and time.
-
Created By: name of the user responsible for creating the connection.
-
Updated At: date and time of the last update.
-
Updated By: name of the user responsible for the last update.
-
Last Executed At: date and time of the last data synchronization.
For Sensedia gateways, in addition to the fields above, the following are displayed:
-
Manager Domain: URL of the Sensedia API Manager
-
Token: your Sensedia access token. This data is not displayed for security reasons.
For AWS gateways, in addition to the fields above, the following are displayed:
-
AWS Access Key Id
-
AWS Secret Access Key Id: The key is not displayed for security reasons.
API Imports
Below the general connection information panel, there is the API IMPORTS panel, from which you can manage API imports for the connection.
![detail of the integrations screen with the api imports panel](_images/integrations-api-imports.png)
Imports Listing
The APIs are listed in a table, which includes the following columns:
-
NAME: API name;
-
REGION: region where the API is deployed;
-
API ID: API identifier;
-
PROTOCOL TYPE: communication protocol;
-
STATUS: import status:
-
DONE: indicating that the import was successfully completed;
-
IN PROGRESS: indicating that the import is in progress;
-
FAILED, indicating that synchronization of one or more APIs failed;
-
NOT STARTED: indicating that the import has not yet started.
-
In addition to this information, the ACTIONS column provides the following icons/buttons for you to:
-
: update the list. It’s not possible to update data with IN PROGRESS or NOT STARTED status.
-
: view more about the import.
-
: allow deletion of the import. It’s not possible to delete an import with IN PROGRESS or NOT STARTED status.
You can search for specific imports using the following fields, located above the table:
-
Name: search by API name.
-
Status: search by import status.
After filling in the desired fields, click SEARCH.
To clear filled fields, click CLEAR.
To update the API list, click .
Viewing Details of a Specific Import
By clicking the button of a specific import in the imports listing, you can view more information about that import.
You will be redirected to a new screen containing two panels:
-
DETAILS, which displays the import information;
-
EXECUTIONS, which displays a list of information about each attempt to synchronize the import data.
DETAILS
The DETAILS panel presents the following information about the import:
-
API Id: API identifier;
-
Name: API name;
-
Region: region where the API is deployed;
-
Protocol Type: communication protocol,
-
Status: status of the last import update execution:
-
DONE: indicating that the import was successfully completed;
-
IN PROGRESS: indicating that the import is in progress;
-
FAILED, indicating that synchronization of one or more APIs failed;
-
NOT STARTED: indicating that the import has not yet started.
-
-
Created At: creation date and time;
-
Created By: user responsible for the creation.
You can tell whether the connection is Sensedia (![]() ![]() |
EXECUTIONS
The EXECUTIONS panel displays a list of information about each attempt to synchronize the import data.
Here you can see:
-
STARTED BY: user who initiated the import execution.
-
STATUS: synchronization status:
-
DONE: indicating that data synchronization was successfully completed;
-
IN PROGRESS: indicating that synchronization is in progress;
-
FAILED, indicating that synchronization of one or more APIs failed;
-
-
REASON FOR FAILURE: reason for the failure, if the synchronization failed.
-
TYPE: indicates how the execution was initiated, whether automatic (AUTOMATIC) or manual (MANUAL).
-
Started At: start date and time.
-
Finished At: end date and time.
By clicking the icon of a specific execution, you can view more information about it in the ACTIONS column:
-
Execution Id: unique identifier of the execution.
-
Log: execution log message.
Share your suggestions with us!
Click here and then [+ Submit idea]