Apiman Installation Guide

This guide provides detailed information about how to install and configure Apiman.

Switching formats

On some pages different configuration instructions and examples are available for each platform. They merely encode the same information using different formats.

Vert.x

Your configuration file for Vert.x is your chosen conf.json file, so refer to the JSON examples.

Servlet

Your configuration file for Servlet is apiman.properties!, so refer to the properties examples.

Understanding syntax

In many places in the documentation you will see format agnostic syntax which can be translated trivially into your chosen format.

For example:

Name Type Description

project.name

String

The project name

project.type

Enum

Must be one of: JAVA, GO

project.tags

String[]

Array of tags describing project

project.version.major

Integer

Project major release version

project.version.minor

Integer

Project minor release version

project.version.micro

Integer

Project micro release version

project.favourite

Boolean

Favourite project?

As JSON

{
  "project": {
    "name": "apiman",
    "type": "JAVA",
    "tags": ["api-management", "excellent"],
    "version": {
        "major": 1,
        "minor": 3,
        "micro": 0
    },
    "favourite": true
  }
}

As Properties

project.name=apiman
project.type=JAVA
project.tags=api-management,excellent
project.version.major=1
project.version.minor=3
project.version.micro=0
project.favourite=true