Model

These CodeGen configurations manage the model-specific behavior in the generated SDKs.

Enable Additional Model Properties

In cases where your OpenAPI specification holds additional properties of models, you can use this setting to determine whether to include them in the generated SDK or not. Enabling this option allows models to include additional properties in a map structure.

If an endpoint response (with response-type model) contains additional properties that are not part of the model definition, they will be discarded during serialization and deserialization of the model.

Usage

To use this feature, you need to specify a Boolean value. By default, its value is set to false.

"info": {
    ...,
    "x-codegen-settings": {
        "EnableAdditionalModelProperties": false
    }
}

Language Support

C#	Java	PHP	Python	Ruby	TS	Go
✔️	✔️	✔️	✔️	✔️	✔️	❌

Use Model Prefix

Enabling this setting will postfix each model class with the word "Model".

This setting is helpful in cases where in an OpenAPI specification, an API, endpoint, model, controller etc. might have the same name which can lead to confusion. So, to distinguish between them, you can use this setting to specify that it is a model. For example, a model Person becomes PersonModel.

note

Try to use this setting only if there's a chance of naming conflicts in your API specification file.

Usage

To use this feature, you need to specify a Boolean value. By default, its value is set to false.

"info": {
    ...,
    "x-codegen-settings": {
        "UseModelPrefix": false
    }
}

Language Support

C#	Java	PHP	Python	Ruby	TS	Go
✔️	✔️	✔️	✔️	✔️	✔️	❌

Change in SDK

Configuring this setting has the following effect on the generated SDK:

C#

Value	Change
true	PersonModel result = await responseTypesController.GetModelAsync();
false (default)	Person result = await responseTypesController.GetModelAsync();

Java

Value	Change
true	CompletableFuture<PersonModel> queryEchoAsync( final Map<String, Object> queryParameters)
false (default)	CompletableFuture<Person> queryEchoAsync( final Map<String, Object> queryParameters)

PHP

Value	Change
true	function sendDeleteBody(DeleteBodyModel $body): ServerResponseModel
false (default)	function sendDeleteBody(DeleteBody $body): ServerResponse

Python

Value	Change
true	from tester.models.person import PersonModel
false (default)	from tester.models.person import Person

Ruby

Value	Change
true	body = DeleteBodyModel.from_hash(APIHelper.json_deserialize( '{"name":" ","field":"QA"}', false))
false (default)	body = DeleteBody.from_hash(APIHelper.json_deserialize( '{"name":" ","field":"QA"}', false))

TypeScript

Value	Change
true	async queryEcho( queryParameters?: Record<string, string>, requestOptions?: RequestOptions ): Promise<ApiResponse<PersonModel>>
false (default)	async queryEcho( queryParameters?: Record<string, string>, requestOptions?: RequestOptions ): Promise<ApiResponse<Person>>

Deprecated Settings

We have marked the following CodeGen settings as deprecated since we will no longer provide support for them in the future.

Generate Models

This setting allows you to choose whether to include models in the generated SDKs and docs or not. You can disable this setting to use maps instead of models.

If you choose to disable this setting, APIMatic CodeGen will not generate any Model related code. Which means, all model related requests and responses will have to be maintained manually.

note

Turning off Model code generation goes against the best practices of writing a client SDK, so we have marked this setting as deprecated.

Usage

To use this feature, you need to specify a Boolean value. By default, its value is set to true.

"info": {
    ...,
    "x-codegen-settings": {
        "GenerateModels": true
    }
}

Language Support

C#	Java	PHP	Python	Ruby	TS	Go
❌	❌	❌	✔️	✔️	❌	❌

Enable Immutable Models

This setting determines the immutability of models within the generated SDKs. By enabling this option, the current value of models in the generated SDKs becomes locked, preventing modifications when building requests from your SDK.

note

This setting has been marked as deprecated because, by default, the process of building a request is intended to be flexible. Restricting the values of models is generally regarded as a bad practice, which is why we discourage the use of this setting.

Usage

To use this feature, you need to specify a Boolean value. By default, its value is set to false.

"info": {
    ...,
    "x-codegen-settings": {
        "EnableImmutableModels": false
    }
}

Language Support

C#	Java	PHP	Python	Ruby	TS	Go
✔️	✔️	❌	❌	❌	❌	❌

Change in SDK

Configuring this setting has the following effect on the generated SDK:

C#

Value	Change
true	DeleteBody body = new DeleteBody.Builder("name6", "field0") .Build()
false (default)	DeleteBody body = new DeleteBody(); body.Name = "name6"; body.Field = "field0";

Java

Value	Change
true	DeleteBody body = new DeleteBody.Builder( "name6", "field0") .build();
false (default)	DeleteBody body = new DeleteBody(); body.setName("name6"); body.setField("field0");

Ignore If Null JSON

note

Please note that this setting is experimental and may not function properly in all cases. Feel free to contact our support if you run into an issue.

In the API specification file, a null property is defined as an optional property. But in cases where null is not defined properly, you can enable this setting and the generated SDK will ignore all null properties during JSON serialization of a model.

tip

To avoid using this setting altogether, it is recommended to ensure that your OpenAPI specification file accurately denotes null values as null, optional values as optional, and nullable optional values as such. By following this practice, you can ensure the generation of correct requests across all programming languages.

Usage

To use this feature, you need to specify a Boolean value. By default, its value is set to false.

"info": {
    ...,
    "x-codegen-settings": {
        "IgnoreIfNullJson": false
    }
}

Language Support

C#	Java	PHP	Python	Ruby	TS	Go
❌	❌	✔️	✔️	✔️	❌	❌