Bearbeiten eines Aufrufs mit unbekannten Elementen

Ein System-API-Aufruf kann Nutzdaten enthalten, welche eine Eigenschaft enthalten, die im zugehörigen Schema nicht definiert ist. Standardmäßig weisen die System-APIs unbekannte Eigenschaften zurück. Sie können das Standardverhalten überschreiben, indem Sie den GW-UnknownPropertyHandling-Header einschließen. Der Header muss auf einen der folgenden Zeichenfolgenwerte gesetzt sein:

  • ignore: Ignoriert alle unbekannten Eigenschaften. Es werden keine Meldungen protokolliert und keine Validierungsfehler zurückgegeben.
  • log: Protokolliert eine dienstseitige Infomeldung, verarbeitet den Aufruf jedoch dann und ignoriert dabei alle unbekannten Eigenschaften.
  • reject: Verarbeitet den Aufruf nicht. Gibt einen Validierungsfehler zurück, der angibt, dass unbekannte Eigenschaften vorhanden sind.

Ebenso kann ein System-API-Aufruf eine URL mit einem Abfrageparameter enthalten, der im zugehörigen Schema nicht definiert ist. Standardmäßig weisen die System-APIs Aufrufe mit unbekannten Abfrageparametern zurück. Sie können das Standardverhalten überschreiben, indem Sie den GW-UnknownQueryParamHandling-Header einschließen. Der Header muss auf einen der folgenden Zeichenfolgenwerte gesetzt sein:

  • ignore: Ignoriert alle unbekannten Abfrageparameter. Es werden keine Meldungen protokolliert und keine Validierungsfehler zurückgegeben.
  • log: Protokolliert eine dienstseitige Infomeldung, verarbeitet den Aufruf jedoch dann und ignoriert dabei alle unbekannten Abfrageparameter.
  • reject: Verarbeitet den Aufruf nicht. Gibt einen Validierungsfehler zurück, der angibt, dass unbekannte Abfrageparameter vorhanden sind.