swagger-2.0

5Hitze

1Antwort

Swagger: Unterstützung für optionale Routen

Ich habe eine Route mit einem optionalen Parameter: [Route("{categoryId?}")] public HttpResponseMessage Get(int? categoryId=null) Allerdings, wenn ich für categoryId keinen Wert biete der Anruf

16Hitze

3Antwort

Wie senden Autorisierungsheader mit einer Anfrage in Swagger UI?

Ich habe eine ASP.NET Web Api 2-Anwendung. Ich habe Swashbuckle hinzugefügt (Swagger für .NET). Es zeigt meine Endpunkte kein Problem, aber um eine Anfrage zu senden, muss ich einen Autorisierungshead

27Hitze

2Antwort

Wie beschreibt man diesen POST JSON-Anfragetext in OpenAPI (Swagger)?

Ich habe eine POST-Anfrage, die den folgenden JSON-Anfragetext verwendet. Wie kann ich diesen Anfragetext mit OpenAPI (Swagger) beschreiben? { "testapi": { "testapiContext": { "messa

6Hitze

1Antwort

JSON-API-Beispiele in Swagger 2.0

Ich versuche, Beispielantworten für einen Endpunkt mit Swagger 2.0 zu erstellen. 200: description: Successful response schema: type: object $ref: "#/definitions/User" exa

35Hitze

6Antwort

So brechen Sie Swagger 2.0 JSON-Datei in mehrere Module

Ich versuche, mein API-Dokument in mehrere JSON-Dateien zu brechen, die unabhängig voneinander bearbeitet werden können. Alle Beispiele, die ich finden konnte, benutzen das Swagger 1.2-Schema, das ein

57Hitze

1Antwort

Swagger/OpenAPI - verwenden Sie $ ref, um einen wiederverwendbaren definierten Parameter zu übergeben

Nehmen wir an, ich habe einen Parameter wie limit. Dieser wird überall verwendet, und es ist ein Schmerz, es zu haben überall zu ändern, wenn ich es aktualisieren müssen: parameters: - name: limi

9Hitze

1Antwort

Machen Sie Modell-Schema-Capture-Element-Zusatz auf einer Array-Feld-Anfrage

Ich mache einen Adapter für eine REST-API. Ich habe das Modellschema für den Körper der POST- und PUT-Methode verwendet. @RequestBody Model1 requestBody am Adapter. Jetzt habe ich body mit Feldern, di

8Hitze

3Antwort

Wie dokumentiert man OData-Endpunkte (Swagger, Swashbuckle, andere)?

Wie dokumentieren Sie OData-Endpunkte am besten? Gibt es eine Möglichkeit, Swashbuckle dafür zu verwenden?

11Hitze

1Antwort

Wie mache ich ein Feld in einer Definition für einige Operationen und nicht für andere

Ich schreibe meine Swagger-Definition in Yaml. Angenommen, ich habe eine Definition, die ungefähr so aussieht. paths: /payloads: post: summary: create a payload ... param