Skip to content

Configuration

EasyYapi provides a flexible configuration system to customize API documentation generation behavior.

Configuration Methods

Local Config File

Create a .easy.api.config file in your project root or module root directory:

properties
# Ignore specific fields
field.ignore=groovy:it.hasAnn("com.fasterxml.jackson.annotation.JsonIgnore")

# Type conversion
json.rule.convert=groovy:it.type().name()=="java.util.Date" => java.lang.String

See Local Config File.

Remote Config File

Configure a remote URL to fetch configuration:

properties
remote.url=http://your-config-server.com/easy-api.config

See Remote Config File.

IDE Settings

Configure EasyYapi global settings in the IDE.

See IDE Settings.

Configuration Content

CategoryDescription
Config RulesRules for customizing API documentation generation
Callbacks & EventsExecute custom logic at specific events
Script ToolsTools available in Groovy scripts
AdvancedAdvanced custom configuration

Configuration Priority

  1. Remote config (highest priority)
  2. Module root config
  3. Project root config
  4. IDE settings (lowest priority)

Released under the Apache-2.0 License.