Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
OpenAPI-Definitionen einer Beispiel-API mit grundlegender Anforderungsvalidierung
Die folgende OpenAPI-Definition gilt für eine Beispiel-API mit aktivierter Anforderungsvalidierung. Die PetStore-API ist eine Teilmenge der POST
-Methode wird ein Haustier zur Sammlung pets
hinzugefügt und mit einer GET
-Methode erfolgt die Abfrage der Haustiere nach Typ.
In der Zuweisung x-amazon-apigateway-request-validators
sind auf API-Ebene zwei Anforderungsvalidierungen deklariert. Die Validierung params-only
ist für die API aktiviert und wird von der GET
-Methode geerbt. Mit diesem Validator kann API Gateway überprüfen, ob der erforderliche Abfrageparameter (q1
) in der eingehenden Anfrage enthalten und nicht leer ist. Die Validierung all
ist für die POST
-Methode aktiviert. Mit dieser Validierung wird geprüft, ob der erforderliche Header-Parameter (h1
) gesetzt und nicht leer ist. Es wird auch überprüft, ob das Payload-Format dem angegebenen RequestBodyModel
entspricht. Wenn kein passender Inhaltstyp gefunden wird, wird die Anforderungsüberprüfung nicht durchgeführt. Wenn ein Modell zur Validierung des Textes verwendet wird und kein übereinstimmender Inhaltstyp gefunden wird, wird die Anforderungsvalidierung nicht durchgeführt. Um das gleiche Modell unabhängig vom Inhaltstyp zu verwenden, geben Sie es $default
als Schlüssel an.
Bei diesem Modell muss das JSON-Objekt der Eingabe die Eigenschaften name
, type
und price
enthalten. Die Eigenschaft name
kann eine beliebige Zeichenfolge sein, type
muss einem der angegebenen Aufzählungsfelder (["dog", "cat", "fish"]
) entsprechen und price
muss zwischen 25 und 500 liegen. Der Parameter id
ist nicht erforderlich.