Skip to main content

55 posts tagged with "new feature"

View All Tags

Support for Union Types And Other Type Constructs Added in API Transformer and Dashboard Import

路 3 min read

Support for union types and other type constructs (oneOf, anyOf, not) has now been added to API Transformer and can also affect how your import in the Dashboard works. Re-transform/re-import your files to get these latest changes. Learn more about how (and if) these changes will affect you if you use any of these constructs in your API specification file.

Support for XML Added in API Transformer

路 3 min read

API Transformer now preserves XML examples and XML serialization attributes like XML node name, prefix, namespace, etc. which reduces loss of information when converting between popular formats that support XML like OAS, RAML, WSDL, WADL, etc.

Support for Postman API Key Authentication and Disabled Request Body Added

路 One min read

Postman recently introduced API Key authentication in its latest app and corresponding Postman Collection versions. API Transformer and other APIMatic products now support this feature for all import/export purposes. In addition to this, we now also handle disabled request bodies (another new feature introduced by Postman) when importing Collection files.

Logging in Java

路 2 min read

We've added logging to our Java SDKs. Logging-enabled SDKs will log important events in the API lifecycle for troubleshooting or debugging later.

Added Java Version to POM File

路 One min read

We have added information about the minimum required Java version to the pom.xml file in Java projects. The enforced version has not changed and is still Java 7. Previously if the user tried to use our Java SDK with a lower version, they would face compilation failure and receive error messages that were sometimes ambiguous. Now a Maven build failure is caused which clearly informs the user that the problem is with the version of Java being used. To benefit from this change, please generate your Java SDKs again.

Do-Not-Split Words in Code Generation Settings

路 2 min read

We have added a new CodeGen setting that allows you to specify a list of words that Code Generation will not split when converting identifiers from API specification to language-specific identifiers. This is useful for declaring brand names such as APIMatic.

E.g. if you provide the words apimatic and vmware in your the list, APIMaticandvmWare becomes ApimaticAndVmware or apimatic_and_vmware, depending on the place of use.

Rolling Out Long Awaited Major Improvements to Transformer

路 4 min read

For the past few months, we have been hard at work improving API Transformer to give our users good quality output for any of their conversions. This changelog highlights all improvements made and new features added which we plan to release in a few weeks from now. To get full advantage of these improvements, some of the users who import from various formats like OpenAPI/Swagger, API Blueprint, etc. may need to regenerate their portal/SDKs.

Major Release of Developer Experience Portal

路 2 min read

We've rewritten our Developer Experience portal and are releasing it as a major version. The new version introduces several new features in addition to bug fixes to some long-standing issues.

Check out the changes and how to migrate to the new portal.

Go Improvements

路 One min read

Our GO SDK has been revamped pertaining to multiple bug fixes and new features.

  • It now supports OAuth 2.0 Bearer Token for authentication in the generated SDKs.
  • It now has a base client that can be used as a single point of entry for the SDK.
  • The singleton architecture for clients has been removed to ease up the use in multiple user environments.
  • Numerous bug fixes and improvements.

Support for Nullable Properties Added to Transformer

路 One min read

A property is nullable if it allows sending null (in case of JSON/YAML, etc.) or nil (in case of XML) as value. Several API description formats like Open API, RAML, etc. has support for nullable properties. Transformer now also supports this property and you can convert between different formats without losing this information.

Support for Validation Keywords Added In Transformer

路 2 min read

Several API description formats like Swagger, RAML, WSDL, WADL, etc. support various kinds of validation keywords to restrict and validate instance values based on their type. Support for these validation keywords has now been added to Transformer. You can now convert between any of these formats without losing information for these keywords.

Multiple Datetime Formats in PHP

路 One min read

We have now added support for multiple datetime formats in our PHP SDKs. The following formats are supported:

  • RFC1123 Datetime: Mon, 15 Jun 2009 20:45:30 GMT
  • RFC3339 Datetime: 2016-03-13T12:52:32.123Z
  • Unix Timestamp: 1480809600

New Target - .NET Standard SDK

路 One min read

We are excited to announce the latest addition to our long list of supported platforms. Our C# section now has a new template for a .NET Standard library in addition to the already supported PCL and UWP templates. This library targets .Net Standard 1.3.

Discriminator Support Added in Angular

路 One min read

Usage of discriminators is already supported by our code generation engine. We are happy to announce that now support for using discriminators has also been added to AngularJS SDK.

  • Discriminator is a field that is used to differentiate between a parent model and models that inherit from it.
  • The response is deserialized into the parent model or one of its child classes by inspecting the discriminator field's value in the response.
  • Using a discriminator field, you can build leaner models by not having to build unions of fields needed by a polymorphic response.

Please generate your SDK again if you want to use this feature.

Discriminator Support Added in Node

路 One min read

Usage of discriminators is already supported by our code generation engine. We are happy to announce that now support for using discriminators has also been added to Node.

  • Discriminator is a field that is used to differentiate between a parent model and models that inherit from it.
  • The response is deserialized into the parent model or one of its child classes by inspecting the discriminator field's value in the response.
  • Using a discriminator field, you can build leaner models by not having to build unions of fields needed by a polymorphic response.

Please generate your SDK again if you want to use this feature.

Setting Composer Package Name

路 One min read

You can now set Composer Package Name for PHP SDKs being generated.

This will affect the name generated in the composer.json file. Leaving it empty will generate the a fallback package name based on your API name.

Added Support for Postman Environment and Dump files

路 One min read

Now you can upload a ZIP file containing your Postman Collection file along with any Postman Environment Files. That way we will extract values for your environment variables from the Environment files and give a better output during conversions on the Transformer or when importing APIs to your Manage APIs page. Support for Postman data dump files has now been added as well.

ES6 Promises in NodeJS

路 2 min read

NodeJS SDKs will now return promises in endpoint calls, as an alternative to accepting callbacks.

  • We use ES6 Promises which is based on Promises/A+ and is interoperable with most Promise-based implementations.
  • Callbacks are still supported (for backward-compatibility) but are now optional.

Re-generate your NodeJS SDK to get the new Promise-enabled SDK implementation now.

Polymorphic Responses with Discriminator Field

路 One min read

APIMatic Code Generation engine now supports polymorphic responses with the help of a discriminator field.

  • Discriminator is a field that is used to differentiate between a parent model and models that inherit from it.
  • The response is deserialized into the parent model or one of its child classes by inspecting the discriminator field's value in the response.
  • Using a discriminator field, you can build leaner models by not having to build unions of fields needed by a polymorphic response.

Check out the Discriminator documentation to get started.

Added Support for Swagger 1.2 ZIP Files

路 One min read

If you have a Swagger 1.2 API description file split into Resource Listing and API Declaration files, you can import/convert it using a ZIP file. Previously, such API description file could only be converted/imported by providing the Resource Listing file via a URL where all API Declaration files were located relative to this URL.

Added Swagger Type Discriminator Support

路 One min read

Swagger makes use of a property discriminator to support polymorphism in custom types. We have now added support for this property in our system. We also offer an extension that will allow you to specify a custom value for the discriminator to override its default value.

Additional properties now allowed in CSharp

路 One min read

We have now added support for additional properties in models in the CSharp SDK. The additional properties are deserialized and stored in a dictionary inside the model.

This can be enabled via navigating to the Settings > CodeGen Settings page in the API editor and enabling the Enable Additional Model Properties flag.

Swagger Server Configuration Extension

路 One min read

APIMATIC now offers you a swagger extension to specify Server Configuration details within your Swagger file. When you import this file, we will extract the relevant server configuration information from this extension.

Details#

Server configurations can be used to create multiple environments, multiple servers that can be used with specific endpoints and server URLs with template parameters. You can view more details about these configurations at Server Configuration. We have added support for an extension to help you specify this information without having to manually add it through the editor everytime you import your Swagger file. For more details on this extension please see Swagger Server Configuration Extension

Multiple Datetime Formats in Angular

路 One min read

We have now added support for multiple datetime formats in our Angular SDKs. The following formats are supported:

  • RFC1123 Datetime (Mon, 15 Jun 2009 20:45:30 GMT)
  • RFC3339 Datetime (2016-03-13T12:52:32.123Z)
  • Unix Timestamp (1480809600)

NodeJS SDKs Now Have Retries

路 One min read

Node JS SDKs now come with retries for requests. We allow retries for the following cases:

  • GET requests only.
  • General connection errors.
  • Timeout errors.
  • DNS address resolution failure errors.

Re-generate your Node JS SDKs now to get this new feature.

Logging in SDKs

路 One min read

SDKs generated by APIMATIC now support logging events!

  • Logging-enabled SDKs will log important events in the API lifecycle to the console, log file or another logging backend.
  • Logging backends are configurable. You can even plug-in a logging service like Loggly or Sentry into your SDKs.
  • Easily monitor your SDK usage and find bugs when they occur.

We now have a changelog!

路 One min read

Starting today, we are going to maintain an awesome Changelog for APIMATIC. :)

Follow this changelog to stay up-to-date with

  • New Features
  • Bug Fixes
  • Improvements