External API Connections
External API connections are used to import data from APIs to Amorphic Dataset. Only API Authentication of type BASIC is supported as of now.
Creation
Below are the ways to create an External API
BASIC
To create an External API connection, user has to enter API Endpoint, HTTP Method and Query String Parameters. Below image shows how to create an External API Connection
| Attribute | Description |
|---|---|
| Connection Name | Name of the connection Amorphic |
| Connection Type | Type of connection. In this case it is ExternalAPI |
| Description | Connection related information user wants to store |
| Authorized Users | Amorphic users to whom user wants to have access to this connection |
| API Endpoint | Endpoint URL from which data needs to be extracted |
| API Authentication | As of version 1.1.3 only BASIC is supported |
| Method | HTTP Method, as of version 1.1.3 only GET and POST are allowed |
| Query Params | Query string parameters which the API URL takes as input. |
| Version | Enables the user to select what version of ingestion scripts to use (Amorphic specific). For any new feature/Glue version that gets added to the underlying ingestion script, new version will be added to the Amorphic. |
Edit
There is an option to edit an External API Connection. To edit an External API Connection, click the edit button which on the right corner.
Description and Authorised users of an External API Connection can be changed.
Below image shows how to edit an External API connection
Upgrade
User can upgrade a connection (if available) which will be shown in the options. Upgrade option is visible only if there is any new version available else it is not shown.
Connection upgrade upgrades the underlying Glue version and the data ingestion script with new features.
Below image shows how to upgrade a connection
Downgrade
User can downgrade a connection to previous version if he thinks the upgrade is not serving the purpose. A connection can only be downgraded if it has been upgraded. For a connection that has been created we cant downgrade it. The option to downgrade is available on the top right corner if the connection is downgrade compatible.
Deletion
On the top right corner, there is a button with trash can on it. Click on it to delete.
Below image shows how to delete a connection
