Application Mapping REST Interface

Data

Application mapping is a list of dictionary entries. Each entry specifies one particular mapping:

  • application_uuid

    The internal UUID of the mapped application.

  • hosts

    A list of all hosts assigned in the particular mapping.

  • prefixes

    A list of all prefixes assigned in the particular mapping.

For more information regarding application mapping concepts, see Application Mapping, Paths, Preconditions.

For more information regarding editing application mapping using the user interface, see Editing Application Mapping.

Getting the configured customer keys

  • Request

    Method GET

    URL

    /application-mapping/

    Arguments

    –

  • Response

    Reason code Arguments Meaning

    200

    { ..., "customer_keys": [ "" ] }

    dictionary containing all customer keys that are available

    An underscore stands for the empty "[Default Customer Key]"

    401

    –

    no login

    403

    –

    not enough rights

    500

    –

    internal server error

Getting the application mapping for a specific customer key

  • Request

    Method GET

    URL

    /application-mapping/customer_key

    The empty “[Default Customer Key]” needs to be addressed as “_” (underscore).

    Arguments

    –

  • Response

    Reason code Arguments Meaning

    200

    { ..., "customer_keys": [ "" ] }

     

     

    dictionary containing all customer keys that are available

    An underscore stands for the empty "[Default Customer Key]"

    401

    –

    no login

    403

    –

    not enough rights

    404

    –

    no application mapping exists for the given customer key

    500

    –

    internal server error

  • Example

    The following request retrieves the application mapping for the empty [Default Customer Key].

    $ curl -n https://something.com:8087/api/af/latest/application-mapping/_ {    "__name": "_",    "__path": "/api/af/latest/application-mapping/_/",    "__subnodes": [],    "customer_key": "",    "mapping": [      {        "application_uuid": "6b35f8fb2d65288d-5dbded6e7c4389a81c1b28d43eea8628",        "hosts": [          "api.something.de"        ],        "prefixes": [          ""        ]      },      {      ...