Code Generation Settings

APIMATIC’s code generation engine has various code generation configurations to customize the behaviour and outlook across the generated SDKS. Code generation settings can be accessed via Settings > CodeGen Settings in the API editor.

Generic Code Styling

These configurations change the overall look and feel of the generated code.

SettingDescriptionLanguages Applicable
Asynchronous CodeEnabling this generates asynchronous code.

Note   Objective C generates asynchronous code irrespective of this option.

HTTP Method PrefixEnabling this will prefix the HTTP method i.e Get, Create, Update or Delete to the name of the methods. For e.g the endpoint ‘Contact’ using POST becomes CreateContact
Model PostfixPostfixes each model class with the word Model. For e.g the model Contact becomes ContactModel.
Enum PostfixPostfixes each enum class with the word Enum. For e.g the enum Days becomes DaysEnum.
Controller PostfixPostfixes each controller class with the word Controller. For e.g the controller User becomes UserController.
Append JSON HeadersAutomatically determines the request and response content types and appends appropriate “accept” and “content-type” headers.
Use Common LibraryUses a common library comprising of common classes used by the generated SDKs leading to reduced code duplication.
Generate InterfacesGenerates interfaces for controller classes in the generated SDKs.

Note   Objective C and GO generate interfaces irrespective of this option.

Enable LoggingEnabling this generates code in the SDKs for logging events in the API cycle using a library. Logger can be configured in the SDK.
Disable LintingFiles/dependencies used for linting are not generated if this option is enabled.
Sort ResourcesSorts resources such as endpoints, endpoint groups and models in generated documentation. Applies to both read-me files generated with SDKs as well as DX Portal-based documentation.All languages in docs
Do-Not-Split WordsCode Generation will not split these words when converting identifiers from API specification to language-specific identifiers. Only alphanumeric characters are allowed. For e.g. if you provide the words “apimatic” and “vmware” in your white list, APIMaticandvmWare becomes ApimaticAndVmware or apimatic_and_vmware, depending on the case used in the SDK language.

Configuration Settings

These configurations are pre dominantly platform specific settings choosing between different programming paradigms for that particular language

SettingDescriptionLanguages Applicable
Use AndroidManifest.xmlConfiguration parameters are populated in the Android Manifest file if this option is enabled.
Use AppInfo.plistConfiguration parameters are populated in the Appinfo.plist file if this option is enabled.
Generate CoreDataCoreData is a native framework for persistence in iOS. Enabling this option generates a CoreData model document combining all the models in the project. It also generates entity classes which are required for CoreData.
Enable PHP Composer Version StringEnable to add version component to composer.json file. This can cause conflicts with Git tag-based version publishing and should be used with caution.

Endpoint Settings

These configurations manage the endpoints specific behaviour in the generated SDKs.

SettingDescriptionLanguages Applicable
Collect ParametersEnabling this option collects API endpoint parameters as collections instead of individual method parameters.
Nullify 404Enabling this would return null response on the HTTP status code 404.
Validate Required ParametersEnabling this option validates required API endpoint parameters to be not null.

Note   Default values for required parameters are ignored.

Preserve Parameter OrderEnabling this attempts to preserve the parameter order in endpoints and models as defined by the user.
TimeoutThis option specifies the duration (in seconds) after which requests would timeout.
Allow Skipping SSL Certificate VerificationCreate a configuration option in SDKs to optionally skip certificate verification when establishing HTTPS connections.

Model Settings

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

SettingDescriptionLanguages Applicable
Enable Additional Model PropertiesEnabling this option allows models to have additonal properties. If an endpoint response (with response-type of model) contains additional properties that are not part of the model definition, these will not be discarded during deserialization and serialization of the model.
Ignore Null PropertiesEnabling this option ignore all null properties during serialization of a model as JSON.

Continuous Integration Settings

Apimatic also generates configuration files for CI tools. The user can use these settings to toggle the generation of configuration file for specific CI tools.

SettingDescriptionLanguages Applicable
Generate AppVeyorEnabling this option generates configuration file appveyor.yml for AppVeyor.
Generate CircleCIEnabling this option generates configuration file circle.yml for CircleCI.
Generate TravisEnabling this option generates configuration file .travis.yml for Travis.
Generate JenkinsEnabling this option generates configuration file Jenkinsfile for Jenkins.

Code Branding Options

These settings allow white-labeling and personalization of SDKs.

Brand LabelThe specified brand label will be added to the header of all generated files.
Project nameThe name of the project for Generated SDKs.

Note   API name is used as the project name by default.

User AgentThe user agent is added to the headers of all API calls to identify the sender of the request. You can add the language name of the SDK from which the call is made by including {language} in the value and the sanitized API version using {version}.
Enable Global User AgentEnable this to send the User Agent field as the user-agent header or the default user-agent if the User Agent field is empty. Disabling this will NOT disable user-agent from being sent if it exists as an additional header or as an endpoint parameter of type header.
C# default namespaceThe default value of the root namespace to be used in C# SDKs.
Java package nameThe default value of the package name to be used in Java SDKs.
Java Group IDGroup ID to be used in Maven POM file generated in Java SDKs. Group ID must follow Java package name rules.
Composer Package nameSets name in composer.json file for PHP SDKs. You must provide a string with the format your-vendor-name/package-name.
Apply CustomizationsCustomer-specific customizations to be applied during SDK and doc generation. These keys are provided by APIMatic Support team where necessary.

API Monitoring Powered by Runscope

Runscope is a service which allows API providers to monitor their API. In case of any downtime or failing requests, Runscope will notify them so that the issue can be resolved at the earliest.
APIMatic partners with Runscope to enable API providers to inspect/debug all of the request and response data traveling back and forth from the clients using their SDKs.

Enable RunscopeThis flag enables API Monitoring and debugging using Runscope within the generated SDKs
Bucket KeyThis is the key that you’ll get for a bucket (group of endpoints) from Runscope.

Have questions? Submit a request.