In einer Swagger-Spezifikation definiere ich das Schema des Objekts, das von einer Abfrage zurückgegeben wird. Das ist großartig für GETs, aber wenn ich einen POST-Endpunkt habe, könnte es dasselbe Objekt enthalten. Kann ich a json.schema für die "Parameter", die an einen Endpunkt gesendet werden? Das ist a $ref: #/definitions/myObject? Es wäre schade, das Schema zweimal definieren zu müssen, einmal für eingehende und einmal für ausgehende.
Und dann ist es möglich, dass Middleware die Nutzdaten eines Posts dagegen validiert json.schema und ablehnen, wenn die Nutzdaten nicht übereinstimmen?
Es scheint, dass alle Stücke verfügbar sind, also frage ich mich, ob es zusammengezogen wurde oder nicht.
Antworten:
0 für die Antwort № 1Ok, es scheint, ich kann nichts entdecken, bevor ich in Verzweiflung schreibe. Aber ich habe es gefunden.
In der Dokumentation, überraschend. Paramterter. Wenn Sie einen Parametertyp "body" deklarieren, können / müssen Sie einen Schematyp deklarieren. Wie in json.schema. Also das ist der erste Teil.
Dann für Teil zwei gibt es Middleware für Knoten in Swagger-Werkzeuge das validiert die Anfrage und optional dieAntwort. Obwohl es nicht genau ist, glaube ich, dass es den Körper gegen das Schema validieren wird, das ist ziemlich cool. Ich weiß nicht, welche Art von Fehlermeldungen es generiert, hoffentlich etwas konfigurierbar oder zumindest verständlich.