Configuration Service

The configuration service can be used to read configuration in general and variants in particular. It's a subservice to the Content Service and offers a read-only REST API.

REST API

The default base URL for the configuration service is:

http://ace-content-service:8081/config

Show effective configuration

Shows the effective configuration for a given config ID.

GET http://ace-content-service:8081/config/effective/{config-ID}

Returns a JSON object containing overlayed aspects. See Configuration Content for details.

Example

% curl -sL -H "X-Auth-Token: $TOKEN" http://localhost:8081/config/effective/myConfig
{
  "myConfigAspect": {
    "param1": "overridden value",
    "param2": "default value"
  }
}

List variants

Lists all variants available in the content service.

GET http://ace-content-service:8081/config/variants

Returns a JSON string array with variant names.

Example

% curl -sL -H "X-Auth-Token: $TOKEN" http://localhost:8081/config/variants
[
  "aceIndexing",
  "aceTaxonomy",
  ...
]

Show variant

Shows a variant configuration for a given variant name.

GET http://ace-content-service:8081/config/variants/{variant-name}

Returns a variant configuration JSON object.

Example

% curl -sL -H "X-Auth-Token: $TOKEN" http://localhost:8081/config/variants/aceIndexing
{
  "composers": {},
  "mappers": {
    "aceCategorization": "aceIndexing.categorization",
    "aceSecurityContext": "aceIndexing.securityContext"
  },
  "defaultComposers": [
    "aceIndexing.default"
  ]
}