Depending on your environment, APIMatic offers the following ways to transform API definition files to a format of your choice if you have an API definition in one of the supported formats:
Moreover, you can even customize your transformation by adding metadata and additional settings provided by APIMatic so that your API definition is a complete package for generating documentation and deployable SDKs.
For more detail on these settings, learn how to Configure Transformer to improve your output.
On the APIMatic Dashboard, click on Transform API.
You can either Upload the API Specification file from your local system, or Specify the URL that points to the API specification file. In case of URLs, make sure that the URL must be a publicly accessible link - i.e. no localhost links or links hidden behind authentication. Select the desired Export Format from the dropdown menu and click on Convert.
APIMatic automatically performs validation on your specified file. If the validation succeeds, click on Proceed, if it fails, resolve any pending errors and provide the file again.
Once transformation is successful, the transformed file is automatically downloaded to your default download location with naming convention
<FileName>-<ExportFormatName>. If it does not download, you may click on the download link provided. If your subscription plan allows, you can also proceed to generate an interactive developer experience portal for your API or view portals of our customers. Otherwise, click Close.
You can use APIMatic's API in any supported language to build API Transformer into your CI/CD pipeline to automatically execute transformations every time changes are pushed. The transformed file is stored on the server for future accessibility. You can transform through a file on the system or uploaded on the server. You can also perform various functions like deleting a transformation, downloading the input file and getting logs for existing transformations.
You can perform the following actions through the Transformer API endpoints: