Fetching an API definition for AWS API Gateway

Export an API defintion as a JSON file compatible with AWS API Gateway from Talend Cloud API Designer.

Before you begin

You have installed cURL. For more information, see the cURL documentation.
You have generated a Personal Access Token from Talend Cloud. For more information, see Generating a Personal Access Token.
You have created an API in Talend Cloud API Designer.

Procedure

Open a command line and enter the following command to export your API definition:

curl --header "Authorization:Bearer {userToken}" -X GET -o {outFile}.json https://apid.{region}.cloud.talend.com/api/v1/api-definitions/{api-id}?format=OpenApi3Aws

Add the correct parameters:

Parameter	Description
{userToken}	Token generated from Talend Cloud.
{outFile}	Path and filename of your API definition. For example: contactsapi.json
{region}	Region for your Talend Cloud account. The value can be: us-west us eu ap au For more information, see Talend Cloud regions and URLs.
{api-id}	ID of the API version to fetch. To get it, open your API in Talend Cloud API Designer and go to Settings > MANAGEMENT API or use the GET method on the /api-definitions endpoint to get a list of API definitions with their IDs.

Execute the command.

Results

Your API definition is exported as a JSON file compatible with AWS API Gateway and saved in the selected directory.

For more information about exporting an API definition with an API gateway compatibility mode, see the Talend Cloud API Designer User Guide.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!

Leave your feedback here