To make your API documentation even more comprehensive and user-friendly, we have added support to add multiple examples against each response status code. This includes support for response headers and multiple content types.
Improvements To The Existing Support for Request Body Content-Type
We have added some improvements to our existing support for how request body Content-Type
headers were handled during import. These changes can reflect in your output for SDK/portal generation or API transformations.
Improved OAuth 2.0 Authorization Code Grant Flow
The OAuth 2.0 authorization code grant flow in the API Portal has been improved to make it more comprehensive and user-friendly. This includes introducing cancellable actions, access token visibility and updates to the UI for selecting scopes or resetting the token.
Support Added for OpenAPI v3 Discriminator Mapping Information
The Discriminator object in OpenAPI v3 supports a set of mapping values that helps determine which schema to map to based on the discriminator property's value in the payload. We have now added support for this set of mapping values in our OpenAPI v3 import and export. Previously, only the key or title
of each schema involved in the hierarchy was considered as its discriminator value or one provided using the x-discriminator-value
extension.
Support for OpenAPI v3.1 Added in APIMatic
Here at APIMatic, we are excited to finally announce support for OpenAPI's newer version v3.1
in all our major offerings including API Transformer, Developer Experience Portal and Code Generation. This format has now become a part of our ever-growing list of supported input and output formats.
Improvements and Changes to Validation Messages
Based on internal and customer feedback, we have revamped our validation messages shown to users during import or generation of artifacts like SDKs/Portal, etc. This release improves message content, introduces a couple of new validation messages and changes severity of some of the older messages.
Revamped PHP SDKs as Immutable Clients, Added Support for PHP 8.0
APIMatic's PHP SDKs have been refactored to immutable clients and now support PHP 8.0 with updated dependencies. All static analysis and linting issues have been resolved, support for optional and nullable has been added along with a new restructured authorization flow, and much more.
Support for User-Defined Test Cases Added in APIMatic For RAML v1.0
We have added support for a RAML annotation that lets you define unit-tests for your RAML v1.0
methods within your specification. These unit-tests are then converted automatically to language-specific tests upon SDK generation.
OpenAPI Fix for HTTP Bearer Authentication
We have released a fix for HTTP Bearer authentication type in our OpenAPI import/transformation which was previously treating JWT as the default bearer authentication type. However, this will no longer be the case unless the bearerFormat
in OpenAPI explicitly declares the format to be JWT
.
APIMatic Code Generator V3
APIMatic V3 (codenamed Titan) is APIMatic's largest release to date, bringing some major improvements to the Code Generator, the API Portal and the portal publishing flow. This changelog covers the new features and improvements in the updated APIMatic Code Generator which now generates vastly improved SDKs.