openapi

2Hitze

1Antwort

Ich schreibe eine Prahlerei spec und ich habe drei verschiedene Endpunkte. Wie separiere ich sie in meiner Dokumentation? Ich möchte eine klare Unterscheidung zwischen Beispiel haben: Benutzer, Beiträ

2Hitze

1Antwort

Wie in einer API zu definieren, seit welcher Version ein Pfad/Parameter unterstützt wird

Wir haben eine wachsende swagger API/openAPI und für die Dokumentation von Änderungen dokumentieren wir gerne auf einem Pfad oder Parameter (und vielleicht Definition) seit welcher Version der API ist

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

26Hitze

4Antwort

Wie definieren sich gegenseitig ausschließende Abfrageparameter in Swagger (OpenAPI)?

Ich habe eine Reihe von Parametern in Swagger wie diese "parameters": [ { "name": "username", "description": "Fetch username by username/email", "required":

2Hitze

1Antwort

außer Kraft setzen "host" und "basePath" am "/ {path}" Ebene

PROBLEM STATEMENT: Für einen "seltsamen" Grund sind alle unsere Operationen einer API haben unterschiedliche "host". Wir haben API wie folgt aus: Betrieb 1: https GET: // host1: port1/api/Ressourcen B

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

4Hitze

1Antwort

In Swagger 2.0 (openapi), wie eine andere Ressource-Definition zwischen POST und PUT-Anforderung haben?

Wenn wir bei einer Nachricht API (zum Beispiel) aussehen will ich es erstellen eine Nachricht erhalten eine Nachricht Update eine Nachricht Eine Meldung der Lage sein, enthält eine externe Referenz (e

14Hitze

1Antwort

verfassen json Körper mit Prahlerei

würde Ich mag mit Swagger einen json Körper senden, wie folgt aus: curl -H "Content-Type: application/json" -X POST -d {"username":"foobar","password":"xxxxxxxxxxxxxxxxx", "email": "[email protected]"

4Hitze

1Antwort

Wofür wird das 'scopes'-Feld des swagger-Sicherheitsschema-Objekts verwendet?

petstore_auth: type: oauth2 authorizationUrl: http://swagger.io/api/oauth/dialog flow: implicit scopes: write:pets: modify pets in your account read:pets: read your pets

1Hitze

1Antwort

Erweiterte JSON-Metadaten mit Swagger/OpenAPI

Ich suche nach einer Möglichkeit, erweiterte Metadaten für JSON-Objekte zu deklarieren, die in einer API verwendet werden, die mit Swagger/OpenAPI angegeben wird (oder etwas Ähnliches, wenn ein andere