To Create an Asset

In Anypoint Exchange private and Exchange portal, to share an API, example, template, or connector means that you first create an asset corresponding to the asset type.

How you create an asset depends on its type.

  • For OAS, HTTP, WSDL, and Custom assets, create the asset directly using the Exchange New menu.

  • For a RAML specification, first use Design Center, and publish the API to Exchange. You can also publish RAMLs programatically using the Exchange API.

  • For an example or template, create each using the Mavenize feature in Anypoint Studio, and publish each to Exchange.

  • For a connector, use the source JAR, POM, and Studio Plugin zip for the connector with the Node.js Connector Uploader application to publish to Exchange.

Each asset in Exchange is versioned. You can manage which versions are visible by deprecating a version to hide it, and you can delete versions if needed.

Note, in addition to asset versions, APIs have a consumer facing API version that is shown at the top of an asset’s detail screen. This API version is defined by API providers.

This illustration summarizes how each asset type (in blue) appears in Exchange:

Illustration - How Assets appear in Exchange

Creating an API Asset

An API asset specifies what an interface consists of including its functions, descriptions, how to handle return codes, and dependencies.

  1. In Exchange, click New.

  2. Specify a name for the asset.

  3. Click the asset type from the drop-down list:

    • API Spec - OAS: Provide an OAS/Swagger API specification file.

    • API Spec - WSDL: Provide a WSDL (SOAP API) specification file.

      The HTTP API does not require a file, this type of asset provides an API endpoint that is defined by API Manager.

  4. For the OAS and WSDL assets, click Choose File to locate the API specification file.

  5. Click Publish.

Advanced Settings

Exchange generates the GroupId, AssetId, and Version automatically. You can change the values if needed. For an OAS asset, you can set the asset version and the API version separately.

The Advanced settings are most often used to change the version number.

Creating a Custom Asset

A custom asset lets you share information about any aspect of your organization such as announcements, documentation, videos, and sharing files. You can add an optional file to your Custom asset that users can download. The file is stored in Exchange.

  1. Click New.

  2. Specify a name for the asset.

  3. Click the Custom Asset Type.

  4. If you want to share a file with users, click Choose File to locate the file.

  5. Click Publish.