API-V2 REST Header-Modifier

Header-Modifiers

Header-Name

Werte

Default

Beschreibung

X-ExplodeFlatChainProperties

true / false

true

true: Chain-Properties werden als verschachteltes Objekt zurückgegeben

false: Chain-Properties werden als einzelnes Objekt zurückgegeben (Punkt im Namen)

X-AccessDeniedReplacement

[String]

Ist ein Wert gesetzt werden AccessDenied-Handler durch dessen Wert ersetzt. Im Falle einer Rechteverletzung wird stattdessen der Header-Wert als string zurück gegeben (Diese Option ist nicht Typen-sicher, da im Fall einer Zugriffsverweigerung immer ein String zurückgegeben wird, unabhängig vom ursprünglichen Typ der Property)

Beispiele

Standard

GET /servicedmcore/CoreIdentity/20?fields=id,foreign_id,ci_given_name,foreign_id,ci_given_name,core_identity_type.id

{
    "ci_city": {
        "was_access_denied": true,
        "value": null
    },
    "ci_given_name": {
        "was_access_denied": false,
        "value": "Hansueli"
    },
    "foreign_id": "TestForeignId",
    "id": 20,
    "core_identity_type": {
        "id": {
            "was_access_denied": false,
            "value": 1
        }
    }
}

FlatChain

GET /servicedmcore/CoreIdentity/20?fields=id,foreign_id,ci_given_name,foreign_id,ci_given_name,core_identity_type.id
--header 'X-ExplodeFlatChainProperties: false'

{
    "ci_city": {
        "was_access_denied": true,
        "value": null
    },
    "ci_given_name": {
        "was_access_denied": false,
        "value": "Hansueli"
    },
    "core_identity_type.id": {
        "was_access_denied": false,
        "value": 1
    },
    "foreign_id": "TestForeignId",
    "id": 20
}

AccessDeniedReplacement

GET /servicedmcore/CoreIdentity/20?fields=id,foreign_id,ci_given_name,foreign_id,ci_given_name,core_identity_type.id
--header 'X-AccessDeniedReplacement: >>AccessDenied<<'

{
    "ci_city": ">>AccessDenied<<",
    "ci_given_name": "Hansueli",
    "foreign_id": "TestForeignId",
    "id": 20,
    "core_identity_type": {
        "id": 1
    }
}

Kombination

GET /servicedmcore/CoreIdentity/20?fields=id,foreign_id,ci_given_name,foreign_id,ci_given_name,core_identity_type.id
--header 'X-ExplodeFlatChainProperties: false'
--header 'X-AccessDeniedReplacement: >>AccessDenied<<'

{
    "ci_city": ">>AccessDenied<<",
    "ci_given_name": "Hansueli",
    "core_identity_type.id": 1,
    "foreign_id": "TestForeignId",
    "id": 20
}