OAS allows you to set optional/required
properties in models. While serializing a model, optional properties will be omitted if the value of property is not set (i.e. initialized with null) and, required properties will be serialized in any case. This is a case of factoring schema in oneOf/anyOf
. Now with this support, you can define properties with the same names but with different optional/required constraints in request/response
of an endpoint.
42 posts tagged with "Improvement"
View All TagsIntroducing API Specification Export, Error Message Enhancements in Self Hosted API Portals
APIMatic’s Self Hosted Portal offering has been augmented with the following enhancements:
- API Specification export
- Detailed and informative exception messages
- Ignore MacOS specific files in build input
Handling Object Type as Dictionary for oneOf and anyOf in Java SDKs
OpenAPI Specification allows you to add an object
type in oneOf
and anyOf
in Java SDKs. Defining an object
type means any key/value pair is accepted. Object
type in Java means it can refer to any instance, as Object
is the root class. Therefore, this change enforces that for any object
type case falling under oneOf
and anyOf
, the Java SDK will treat it as Map
.
Updating Type Hints for Dictionaries in PHP SDKs
APIMatic CodeGen has made improvements by updating type hints of dictionaries in PHP SDKs to better capture the type information.
Improvements to Error Messages and Code Formatting in API Portal
Based on the various feedbacks given to us, we have enhanced our error messages shown on the API Portal visible to the users while making API calls via the API code playground. This release improves the message content by adding some more useful information to the older error message.
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.
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.
OpenAPI v2.0 and v3.0 Importers See Major Revamp
Our OpenAPI importers (both v2.0 and v3.0) have undergone a complete overhaul that includes some major performance improvements, bug fixes and other refinements.