When storing an API in a git repository the gateway’s policies and configuration resources must be exported to files. API Gateway Manager supports two different formats:

• GMU Single File

• APIIDA Enhanced Format

Please note that GMU Single File is primarily meant to read already existing repositories. Its use is highly discouraged, as it is not well suited for git-based storage. This format contains timestamps and version numbers, that change with every push to the repository, making it hard to track what actually changed. APIIDA’s Enhanced Format takes care of this by removing timestamps and version numbers before a push to a git repository.

APIIDA’s Enhanced Format also splits up the actual policies from configuration. This eliminates nested XML structures. Everything that is not a policy is also stored conveniently in JSON, so that automated processes are much easier to implement. On top of that JSON is a much better fit for git, as it maintains its validity in automatic merges most of the time, while XML tends to break.