Exporting an API definition - Cloud

Talend Cloud APIs User Guide

Version
Cloud
Language
English
Product
Talend Cloud
Module
Talend API Designer
Talend API Tester
Talend Data Preparation
Talend Data Stewardship
Talend Management Console
Content
Design and Development > Designing APIs
Design and Development > Testing APIs
Last publication date
2024-03-15

Use the GET method on the /api-definitions/{id} endpoint to export an API definition from Talend Cloud API Designer.

For use cases using this request, see Talend Cloud API Designer Examples.

Before you begin

Procedure

  1. Open Talend Cloud API Tester and create a new request.
  2. Keep the default GET method and enter the following URI with the correct parameters:
    https://apid.{region}.cloud.talend.com/api/v1/api-definitions/{api-id}
    Parameter Description
    {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.
  3. Optional: Expand QUERY PARAMETERS and click Add query parameters.
    The following parameters are available:
    Parameter Description
    format Format in which you want to export your definition. The value can be:
    • OpenApi3 (default value)
    • Swagger20
    • Swagger12
    • Raml10
    • Raml08
    • OpenApi3Aws (format compatible with AWS API Gateway)
    • Swagger20Azure (format compatible with Azure API Management)
    talendExtensions Specify if you want your exported definition to contain Talend extensions or annotations. The value can be true or false. The default value is false.
    Note: Talend extensions are not compatible with AWS API Gateway and Azure API Management. If you have entered OpenApi3AWS or Swagger20Azure in the format parameter, this parameter is ignored.
  4. Click the Add header button and enter Authorization in the name field and Bearer followed by a space and your token in the value field.
    Tip: In Talend Cloud API Tester, you can add your token as a private environment variable and reference it in your requests using the expression builder. For more information, see Using environments.
  5. Once your request is configured, click Send.

    Example

    In Talend Cloud API Tester, the request is configured.

Results

Talend Cloud API Tester returns a response containing the API definition in the selected format. You can click the Download button at the bottom of the page to save it.
The Download button at the bottom right of the page.