Tenant configurations

Manage Tenant Configurations

Retrieving configurations

get

Retrieves a list of configurations.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

Query parameters

keysstringOptional

Responses

200

OK

application/json

keystring · min: 1Required

Configuration key.

valueone ofRequired

Configuration value. It can be any valid JSON object.

objectOptional

or

stringOptional

or

object[]Optional

or

booleanOptional

versionintegerOptional

Configuration version.

descriptionstringOptional

Describes purpose of the configuration.

securedbooleanOptional

Flag indicating whether the configuration should be encrypted. It works only if value field is of string type.

Default: false

restrictedbooleanOptional

Flag indicating whether the configuration should be restricted. When configuration is rectricted then it cannot be deleted. When this property is set to true then it cannot be unset.

Default: false

readOnlybooleanOptional

Flag indicating whether the configuration should be readOnly. When configuration is readOnly then it cannot be updated.

Default: false

schemaUrlstring · uriOptional

URL of Json Schema for validation purpose. When configuration is created this value can be provided and then each update operation will be validated against this schema. This property cannot be updated so once set it cannot be unset. The Json Schema should contain one root property named value in order to work correctly. An example of a valid schema: { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "required": ["value"], "properties": { "value": { "type": "boolean" } } }

get

/configuration/{tenant}/configurations

HTTPcURLJavaScriptPython

GET /configuration/{tenant}/configurations HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

OK

[
  {
    "key": "customer.deletion.redirecturl",
    "secured": false,
    "value": "https://tenant.com/custDelete?token=",
    "version": 1
  },
  {
    "key": "customer.passwordreset.redirecturl",
    "secured": false,
    "value": "https://tenant.com/changePassword?token=",
    "version": 1
  },
  {
    "key": "customer.changeemail.redirecturl",
    "secured": false,
    "value": "https://tenant.com/emailChangeConfirm?token=",
    "version": 1
  },
  {
    "key": "cust.notification.email.from",
    "secured": false,
    "value": "[email protected]",
    "version": 3
  },
  {
    "key": "project_country",
    "secured": false,
    "value": "EN",
    "version": 2
  },
  {
    "key": "project_curr",
    "secured": false,
    "value": "[{\"id\":\"EUR\",\"label\":\"Euro\",\"default\":true,\"required\":true}]",
    "version": 3
  },
  {
    "key": "project_lang",
    "secured": false,
    "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true}]",
    "version": 2
  },
  {
    "key": "taxConfiguration",
    "secured": false,
    "value": {
      "taxClassOrder": [
        "FULL",
        "HALF",
        "ZERO"
      ],
      "taxClasses": {
        "FULL": 19,
        "HALF": 7,
        "ZERO": 0
      }
    },
    "version": 2
  },
  {
    "key": "packagingConf",
    "secured": false,
    "value": {
      "packagingGroupOptions": [
        "1_cooling_product",
        "2_standard",
        "3_fragile"
      ],
      "packagingPositionOptions": [
        "1_bottom_robust",
        "2_bottom_insensitive",
        "3_middle_standard",
        "4_top_sensitive"
      ]
    },
    "version": 2
  },
  {
    "key": "storefront.htmlPage",
    "secured": false,
    "value": "index.html",
    "version": 1
  },
  {
    "key": "storefront.host",
    "secured": false,
    "value": "tenant.com",
    "version": 1
  },
  {
    "key": "unitConf",
    "secured": false,
    "value": [
      {
        "units": {
          "LTR": {
            "availableUnitValue": 1,
            "conversion": {
              "MLT": 1000
            }
          },
          "GRM": {
            "availableUnitValue": 100,
            "conversion": {
              "KGM": 0.001
            }
          },
          "KGM": {
            "availableUnitValue": 1,
            "conversion": {
              "GRM": 1000
            }
          },
          "MLT": {
            "availableUnitValue": 100,
            "conversion": {
              "LTR": 0.001
            }
          }
        },
        "name": "UnitConfiguration",
        "description": "This object holds the unit configurations and the factors to calculate between different units"
      }
    ],
    "version": 1
  }
]

Creating configurations

post

Creates new configurations.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

Bodyall of[]

application/json

keystring · min: 1Required

Configuration key.

valueone ofRequired

Configuration value. It can be any valid JSON object.

objectOptional

or

stringOptional

or

object[]Optional

or

booleanOptional

versionintegerOptional

Configuration version.

descriptionstringOptional

Describes purpose of the configuration.

securedbooleanOptional

Flag indicating whether the configuration should be encrypted. It works only if value field is of string type.

Default: false

restrictedbooleanOptional

Flag indicating whether the configuration should be restricted. When configuration is rectricted then it cannot be deleted. When this property is set to true then it cannot be unset.

Default: false

readOnlybooleanOptional

Flag indicating whether the configuration should be readOnly. When configuration is readOnly then it cannot be updated.

Default: false

schemaUrlstring · uriOptional

URL of Json Schema for validation purpose. When configuration is created this value can be provided and then each update operation will be validated against this schema. This property cannot be updated so once set it cannot be unset. The Json Schema should contain one root property named value in order to work correctly. An example of a valid schema: { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "required": ["value"], "properties": { "value": { "type": "boolean" } } }

Responses

201

Created

application/json

400

Bad Request

application/json

409

Conflict

application/json

post

/configuration/{tenant}/configurations

HTTPcURLJavaScriptPython

POST /configuration/{tenant}/configurations HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 278

[
  {
    "key": "project_country",
    "secured": false,
    "value": "DE",
    "version": 1
  },
  {
    "key": "project_lang",
    "secured": false,
    "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true},{\"id\":\"de\",\"label\":\"German\",\"default\":false,\"required\":false}]",
    "version": 1
  }
]

Request exampleCreate invoice settings example

[
  {
    "key": "project_country",
    "secured": false,
    "value": "DE",
    "version": 1
  },
  {
    "key": "project_lang",
    "secured": false,
    "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true},{\"id\":\"de\",\"label\":\"German\",\"default\":false,\"required\":false}]",
    "version": 1
  }
]

Retrieving a configuration

get

Retrieves a specified configuration.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

propertyKeystringRequired

Desired configuration key.

Responses

200

OK

application/json

keystring · min: 1Required

Configuration key.

valueone ofRequired

Configuration value. It can be any valid JSON object.

objectOptional

or

stringOptional

or

object[]Optional

or

booleanOptional

versionintegerOptional

Configuration version.

descriptionstringOptional

Describes purpose of the configuration.

securedbooleanOptional

Flag indicating whether the configuration should be encrypted. It works only if value field is of string type.

Default: false

restrictedbooleanOptional

Flag indicating whether the configuration should be restricted. When configuration is rectricted then it cannot be deleted. When this property is set to true then it cannot be unset.

Default: false

readOnlybooleanOptional

Flag indicating whether the configuration should be readOnly. When configuration is readOnly then it cannot be updated.

Default: false

schemaUrlstring · uriOptional

URL of Json Schema for validation purpose. When configuration is created this value can be provided and then each update operation will be validated against this schema. This property cannot be updated so once set it cannot be unset. The Json Schema should contain one root property named value in order to work correctly. An example of a valid schema: { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "required": ["value"], "properties": { "value": { "type": "boolean" } } }

404Error

application/json

get

/configuration/{tenant}/configurations/{propertyKey}

HTTPcURLJavaScriptPython

GET /configuration/{tenant}/configurations/{propertyKey} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "key": "project_lang",
  "secured": false,
  "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true}]",
  "version": 2
}

Updating a configuration

put

Updates a specified configuration.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

propertyKeystringRequired

Desired configuration key.

Body

application/json

keystring · min: 1Required

Configuration key.

valueone ofRequired

Configuration value. It can be any valid JSON object.

objectOptional

or

stringOptional

or

object[]Optional

or

booleanOptional

versionintegerOptional

Configuration version.

descriptionstringOptional

Describes purpose of the configuration.

securedbooleanOptional

Flag indicating whether the configuration should be encrypted. It works only if value field is of string type.

Default: false

restrictedbooleanOptional

Flag indicating whether the configuration should be restricted. When configuration is rectricted then it cannot be deleted. When this property is set to true then it cannot be unset.

Default: false

readOnlybooleanOptional

Flag indicating whether the configuration should be readOnly. When configuration is readOnly then it cannot be updated.

Default: false

schemaUrlstring · uriOptional

URL of Json Schema for validation purpose. When configuration is created this value can be provided and then each update operation will be validated against this schema. This property cannot be updated so once set it cannot be unset. The Json Schema should contain one root property named value in order to work correctly. An example of a valid schema: { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "required": ["value"], "properties": { "value": { "type": "boolean" } } }

Responses

200

OK

application/json

keystring · min: 1Required

Configuration key.

valueone ofRequired

Configuration value. It can be any valid JSON object.

objectOptional

or

stringOptional

or

object[]Optional

or

booleanOptional

versionintegerOptional

Configuration version.

descriptionstringOptional

Describes purpose of the configuration.

securedbooleanOptional

Flag indicating whether the configuration should be encrypted. It works only if value field is of string type.

Default: false

restrictedbooleanOptional

Flag indicating whether the configuration should be restricted. When configuration is rectricted then it cannot be deleted. When this property is set to true then it cannot be unset.

Default: false

readOnlybooleanOptional

Flag indicating whether the configuration should be readOnly. When configuration is readOnly then it cannot be updated.

Default: false

schemaUrlstring · uriOptional

URL of Json Schema for validation purpose. When configuration is created this value can be provided and then each update operation will be validated against this schema. This property cannot be updated so once set it cannot be unset. The Json Schema should contain one root property named value in order to work correctly. An example of a valid schema: { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "required": ["value"], "properties": { "value": { "type": "boolean" } } }

400

Bad Request

application/json

409

Conflict

application/json

put

/configuration/{tenant}/configurations/{propertyKey}

HTTPcURLJavaScriptPython

PUT /configuration/{tenant}/configurations/{propertyKey} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "key": "project_country",
  "secured": false,
  "value": "AT",
  "version": 1
}

{
  "key": "project_country",
  "secured": false,
  "value": "AT",
  "version": 1
}

Deleting a configuration

delete

Deletes a specified configuration.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

propertyKeystringRequired

Desired configuration key.

Body

application/json

objectOptional

Responses

204

No Content

400

Bad Request

application/json

404

Not Found

application/json

delete

/configuration/{tenant}/configurations/{propertyKey}

HTTPcURLJavaScriptPython

DELETE /configuration/{tenant}/configurations/{propertyKey} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

No content