Tag: swagger

Swagger ist eine framework-Implementierung für die Beschreibung, Produktion, Konsum, und Visualisierung von RESTful-web-services auf Basis Offener API-Spezifikation

So definieren Sie eine Karte, stolzieren?

Anzahl der Antworten 1 Antworten
Arbeite ich an einer API, die auch erzeugt swagger Dokumentation. Das Problem ist, dass aus irgendwelchen Gründen die Anfrage Modell/- schema wird nicht angezeigt, in der swagger-UI, aber ich bekomme keine Fehlermeldung entweder. Ich muss repräsentieren Karte,

Definition von enum-array in Swagger 2.0

Anzahl der Antworten 2 Antworten
type": "array", "items": { "type": "string", "enum": ["MALE","FEMALE","WORKER"] } oder type": "array", "items": { "type": "string", }, "enum": ["MALE","FEMALE","WORKER"] ? Nichts in der spec zu diesem. Das Ziel ist natürlich um swagger-ui zu zeigen, die enum-Werte. Beide

RESTful-API-Testumgebung mit Swagger

Anzahl der Antworten 4 Antworten
Ich versuche zu entwickeln, die eine automatisierte Test-suite für eine REST-API. Ich habe gesagt, dass Swagger wäre das richtige Werkzeug, um dies zu tun. Die API entwickelt, mit dem Spring-Framework. Ich kann nicht herausfinden, wie ich mit

Swagger schicken Sie Körper und formData-parameter

Anzahl der Antworten 2 Antworten
Ich bin mit Swagger 2.0 und ich habe ein problem senden mehrere post-Parameter. Ich habe einen Fors Fehler Operation cannot have a body parameter and a formData parameter und ich weiß nicht, wie es zu lösen ist.

Aktivieren Swagger-UI? Tomcat, SpringMVC, REST

Anzahl der Antworten 2 Antworten
Meine Konfiguration ist wie folgt: pom.xml <dependencies> <!-- Swagger --> <dependency> <groupId>com.mangofactory</groupId> <artifactId>swagger-springmvc</artifactId> <version>0.9.1</version> </dependency> <!-- Swagger WebJar --> <dependency> <groupId>org.webjars</groupId> <artifactId>swagger-ui</artifactId> <version>2.0.24</version> </dependency> </dependencies> root-context.xml <mvc:annotation-driven/> <beans:bean class="com.mangofactory.swagger.configuration.SpringSwaggerConfig" /> Ich die Bereitstellung der Anwendung in Tomcat

Generierung von Rest-API-Dokumentation mit swagger oder einem anderen tool

Anzahl der Antworten 3 Antworten
Ich bin auf der Suche nach einem Weg, um Dokument-meine Rest-APIs. Mein server ist ein Tomcat/Spring-server und der Rest-APIs werden implementiert unter Verwendung von Jenkins. Swagger scheint eine ziemlich Coole Lösung, aber ich kann nicht herausfinden, wie

Spring Boot + Springbox swagger Fehler

Anzahl der Antworten 3 Antworten
Ich habe eine spring-boot-Projekt integrieren wollen, mit swagger via springbox. Habe ich meine spring-boot-app und läuft alles gut. Aber nachdem ich Hinzugefügt springbox, es kann nicht passieren unit-test. Hier sind die details, die ich Hinzugefügt im Projekt.

So veröffentlichen Sie Dateien in Fors (Open API)?

Anzahl der Antworten 3 Antworten
Ich bin mit Swagger zu dokumentieren, meine REST-services. Einer meiner Dienstleistungen erfordert eine CSV-Datei hochgeladen werden. Ich habe Folgendes in der parameters Abschnitt in meinem JSON-API-definition: { "name": "File", "description": "The file in zip format.", "paramType": "body",

Wie integrieren Swagger mit Maven + Java + Jersey +Tomcat

Anzahl der Antworten 3 Antworten
Ich kann nicht scheinen, um zu verstehen, wie zu integrieren Swagger zum generieren der API-Dokumentation. url: ####:8080/MyService/rest/users/getall Ich habe Anmerkungen zu code und der Abhängigkeit. Ich versuche, besuchen Sie: ####:8080/MyService/rest/aber sagt, seine nicht gefunden. //web.xml <servlet> <servlet-name>mycompany-users-serlvet</servlet-name>

Web-Api - Swagger-Dokumentation-Fehler 500

Anzahl der Antworten 6 Antworten
Wenn ich Zugang zu Fors url: http://localhost:28483/swagger/ui/index, wird dieser Fehler erzeugt: 500 : undefined http://localhost:28483/swagger/docs/v1 Irgendwelche Ideen? AKTUALISIERT: Sehen Sie dieses detail Fehler im firebug: Not supported by Swagger 2.0: Multiple operations with path 'api/BimModel' and method

Nicht in der Lage zu bekommen springfox-swagger-ui arbeiten mit Spring MVC

Anzahl der Antworten 4 Antworten
Verbrachte ich ein paar Tage suchen und nicht in der Lage gewesen, eine Lösung zu finden, die meisten Beispiel befassen sich mit spring-boot und gradle, ich bin nur mit spring mvc und maven. Wenn ich entfernen Sie

Wie integrieren swagger mit jersey + spring-boot

Anzahl der Antworten 3 Antworten
Ich bin mit springboot + Trikot für web restful-Implementierung. Nun bin ich dabei, zu integrieren swagger in unserer Anwendung. Ich habe folgende. @Configuration @EnableSwagger2 public class JerseyConfiguration extends ResourceConfig { public JerseyConfiguration(){ register(HelloworldAPI.class); configureSwagger(); } private void

Swagger integration in Dropwizard

Anzahl der Antworten 2 Antworten
Ich bin ziemlich neu zu drop wizard (dropwizard.io) & gerade abgeschlossen Ihre tutorial. Ich würde gerne integrieren Swagger (prahlen.io) in diesem Beispiel-app. Ich fand: github.com/federecio/dropwizard-swagger-sample-app github.com/federecio/dropwizard-swagger Den generierten JSON-scheint Recht ähnlich zu sein, allerdings kann ich nicht

Response-Modells für das spezifische status codes mit Swagger

Anzahl der Antworten 3 Antworten
Ich bin mit Swagger zu dokumentieren, meine REST-API (mit asp.net web-api-2). Gibt es eine Möglichkeit in Fors zu geben-response-Modelle für jeden möglichen Antworten an, die für einen bestimmten api-Aufruf? Ich bin Anmerkungen zu den status-code der Antwort

Swagger Dokumentation für das Frühjahr interface Pageable

Anzahl der Antworten 6 Antworten
Entwickelt ich ein microservice mit Spring Boot. Die Dokumentation für die REST-API mit Swagger. Einige REST-Ressourcen nutzen Frühling Konzepte zu bieten, pagination kostenlos. Unten ist ein Beispiel: @RequestMapping(value = "/buckets", method = GET) public PagedResources list(Pageable pageable,

Wie zu generieren der client-code mit pompös-codegen-plugin (maven -)?

Anzahl der Antworten 3 Antworten
Brauche ich, um zu generieren, eine server-stub-code in eclipse erstellt und mit Fors-codegen-plugin für maven) . Sie können bitte helfen, wie es zu tun ? und welche Konfiguration benötigt( in pom.xml). Der Titel sagt generieren der client-code,

Zum umleiten von Stamm-url auf /Fors/ui/index?

Anzahl der Antworten 7 Antworten
Ich habe eine WebApi-Projekt mit Swashbuckle auf installiert es. Im Standard-setup, muss ich im browser öffnen http://localhost:56131/swagger/ui/index zu meiner Operationen Beschreibung und test Seite. Ich will es zugänglich von der Wurzel der site: http://localhost:56131/. Wie kann ich

oneOf in Swagger-schema funktioniert nicht

Anzahl der Antworten 3 Antworten
Möchte ich definieren PaymentMethod als unten. Ist oneOf unterstützt stolzieren.yaml? PaymentMethod: oneOf: - $ref: '#/definitions/NewPaymentMethod' - $ref: '#/definitions/ExistPaymentMethod' Den ExistPaymentMethod haben nur id, und cardNumber wo NewPaymentMethod keine id, aber alle anderen details, wie z.B. cardNumber, cardholderName,

Was ist Swagger und bezieht es sich auf OData?

Anzahl der Antworten 1 Antworten
Ich bin vertraut mit den Microsoft-stack. Ich bin mit OData für einige meiner restful services. Vor kurzem stieß ich auf Swagger für die API-Dokumentation, und ich versuche zu verstehen, wie es bezieht sich auf OData. Beide von

Wie Sie angeben, dass eine pdf-Datei zurückgegeben, stolzieren?

Anzahl der Antworten 1 Antworten
Ich habe einen Anruf bekommen in meinem swagger REST-API zurückgeben muss, eine pdf-Datei. Es gibt keine klare Beispiel /eine Dokumentation, wie dies zu tun, ohne dass ein syntax-Fehler. responses: 200: description: Returns PDF schema: [application/pdf] und responses:

Geben Sie ein array von strings als parameter body in swagger-API

Anzahl der Antworten 4 Antworten
Ich würde gerne post ein array von strings, wie [ "id1", "id2" ] einem Swagger-basierte API. In meinem swagger-Datei habe ich diese Zeilen: paths: /some_url: post: parameters: - name: ids in: body required: true Was ist der

Senden dynamische benutzerdefinierte Header in swagger-UI-try-outs

Anzahl der Antworten 1 Antworten
Ich bin mit swagger in java. Lese ich einen header namens " callerId durch requestAttributes in den code. Ich bin nicht mit dem Kopf durch die annotation @HeaderParam. weil dies ein Grund, warum der header-Abschnitt ist, nicht

Swagger doc für api-Reaktion (Typ-Liste)

Anzahl der Antworten 1 Antworten
Ich bin mit swagger zum generieren der Dokumentation von mein-REST-API. Aber ich habe Probleme angeben, die Reaktionen von einigen API-Aufrufe. Dies ist mein code: @GET @Path("/self/activities") @Produces(MediaType.APPLICATION_JSON) @ApiOperation(value = "Get all activities created by this user", notes

Api-annotation die Beschreibung ist veraltet

Anzahl der Antworten 5 Antworten
In Fors, @Api annotation ist description ist veraltet. Gibt es eine neuere Möglichkeit, die Beschreibung? Welche Version beziehst du dich auf? github.com/swagger-api/swagger-core/wiki/Annotations-1.5.X oder vielleicht docs.stolzieren.io/swagger-core/current/apidocs/index.html?io/... helfen könnte Ich bin mit version 2.4.0 (springfox) Wie ich sehen kann,

swagger @ApiModelProperty Beispiel-Wert für die Liste<String> Eigentum

Anzahl der Antworten 6 Antworten
Ich habe eine Klasse, in der es ist eine Eigenschaft, die List<String> public class MyClass { .... @ApiModelProperty(position = 2) private List<String> productIdentifiers; .... } Dieser code erzeugt die Beispiel-Werte wie folgt: { "customerId": "1001", "productIdentifiers": [

Swashbuckle/Swagger + ASP.Net Kern: "Fehler beim laden der API-definition"

Anzahl der Antworten 8 Antworten
Entwickle ich eine ASP.NET Core-2-Anwendung und enthalten Stolzieren. Alles funktionierte gut, bis ich eingeführt, eine Methode, die ohne explizit definieren Sie die HTTP-Aktion: public class ErrorController : Controller { [Route("/error")] public IActionResult Index() { return StatusCode(500, new

Wie definieren Swagger 2.0 JSON zu füllen Standard-Körper-parameter-Objekt in Swagger-UI?

Anzahl der Antworten 2 Antworten
Unserer aktuellen Bereitstellung von mustern verlangen, mich manuell zu schreiben, meine swagger json-Ausgabe, die verbraucht wird, durch die Swagger-basierte Benutzeroberfläche im Einsatz in meinem Unternehmen. Ich würde gerne die json-ich Schreibe zu bieten "default" - Werte zum

Swagger Codegen (mit maven-plugin) für die Open API 3.0

Anzahl der Antworten 2 Antworten
Will ich mit Swagger Codegen für Open API 3.0 YAML-Datei. Und ich sehe Swagger Codegen 3.0.0-rc0 verfügbar ist. Aber wenn ich versuche zu verwenden, dass ich laufen in Probleme. Im folgenden sind die details: Meine pom.xml Datei

CORS-Problem auf Swagger-UI

Anzahl der Antworten 5 Antworten
Kann mir jemand sagen, warum bekomme ich diese Fehler. GET http://127.0.0.1:9000/api-docs/service.json 200 OK 4ms swagger-ui.js (line 30261) Unable to Load SwaggerUI /api-docs/(line 83) Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at http://127.0.0.1:9000/api-

So exportieren Sie ein Swagger JSON/YAML-Datei von Swagger-UI?

Anzahl der Antworten 1 Antworten
Wie kann ich exportieren ein Stolzieren-definition-Datei (es sollte ein JSON oder YAML-Datei)? Ich bin gefragt und ich habe nur oberflächliche Kenntnisse über Swagger. Wir haben einen Endpunkt suchen, wie http://example.com//swagger/ui/index#! die wie folgt aussieht (der screenshot ist

Geben Sie ein array als parameter mit Swagger

Anzahl der Antworten 1 Antworten
Wie kann ich angeben, wird ein array als parameter? Zum Beispiel, post /Personen gegeben werden kann, strings username, firstname und lastname, und array myArray. paths: /persons: post: parameters: - name: person_what_is_the_purpose_of_this in: body description: The person to

Swagger 2.0 - wie man "die ein oder andere" parameter erforderlich?

Anzahl der Antworten 4 Antworten
Habe ich ein swagger 2.0 resource unten definiert. Wie kann ich machen "param1 oder param2" erforderlich? Anrufer passieren, entweder param1 oder param2. /some/res: put: summary: some resource responses: 200: description: Successful response schema: $ref: '#/definitions/SomeResponse' parameters: -

SwaggerUI/YAML - sollte NICHT über zusätzliche Eigenschaften additionalProperty: requestBody

Anzahl der Antworten 2 Antworten
Entwurf einer API mithilfe - editor.stolzieren.io ich finde mich nicht in der Lage, fügen Sie eine requestBody Attribut, immer ein Fehler ich kann keine Adresse: Schema error at paths['/projects/{projectId}/user'].post should NOT have additional properties additionalProperty: requestBody Jump

Konfigurieren von Swagger UI mit Spring Boot

Anzahl der Antworten 4 Antworten
Ich versuche zu konfigurieren Swagger UI mit meinem Spring-boot-Anwendung. Obwohl die v2/api-docs zu sein scheint ordnungsgemäß geladen, die http://localhost:8080/swagger-ui.html wird nicht geladen, meine Anmerkungen REST-API. Hier ist was ich habe: pom.xml: ... <!--Swagger UI--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId>

ASP.NET Core - Swashbuckle schaffen nicht Gewinn.json-Datei

Anzahl der Antworten 8 Antworten
Ich habe Probleme damit, die Swashbuckle.AspNetCore (1.0.0) Paket erzeugen keine Ausgabe. Ich lese die Angeberei.json-Datei geschrieben werden sollten '~/swagger/docs/v1'. Aber ich bekomme keine Ausgabe. Begann ich mit einer neuen Marke ASP.NET Kern-API Projekt. Ich sollte erwähnen, das

@ApiParam oder @ApiModelProperty in stolzieren?

Anzahl der Antworten 1 Antworten
Beiden folgenden Anmerkungen, die Arbeit für das hinzufügen von Metadaten zu swagger-ui-docs. Was sollte man bevorzugt und warum? public class MyReq { @ApiModelProperty(required = true, value = "the persons name") @ApiParam(required = true, value = "the persons

Wie Sie angeben, ob ein Feld optional oder erforderlich stolzieren?

Anzahl der Antworten 2 Antworten
Wie definiere ich in Fors, wenn ein Feld optional oder erforderlich und was ist der Standard? InformationsquelleAutor user79074 | 2016-10-18

Die Einstellung der Api-Version mit Swagger-UI

Anzahl der Antworten 3 Antworten
Habe ich eine REST-API entwickelt, die durch die Verwendung von Jersey und dokumentieren wir die REST API, durch swagger-ui. Leider hatten wir nicht starten Versionierung der API von Tag 1. Wir werden jetzt versuchen, fügen Sie die

So ändern Sie die Basis-url von Swagger in ASP.NET Kern

Anzahl der Antworten 5 Antworten
Standardmäßig beim aktivieren von swagger in ASP.NET Kern-Projekt, es ist verfügbar auf url: http://localhost:<random_port>/swagger/ui Ich würde gerne auf einen anderen Basis-url statt /swagger/ui. Wie/wo kann ich konfigurieren, dass? Fand ich, dass für ältere Versionen können Sie die

Konfigurieren von oAuth2 mit Passwort flow mit Swagger-ui in spring boot rest-Anwendung

Anzahl der Antworten 4 Antworten
Ich spring boot rest-api (Ressourcen), die verwendet einen anderen spring-boot-Zulassung-server habe ich Hinzugefügt, Swagger config, um die Ressource zu Anwendung Holen Sie sich eine schöne und schnelle Dokumentation/test-Plattform für die rest-API. mein Swagger config sieht wie folgt

Fors-PHP für die Generierung der JSON-Datei für Swagger-UI

Anzahl der Antworten 2 Antworten
Ich bin versucht, Fors-PHP für die Generierung von JSON-Dateien , so dass ich es verwenden können, mit Swagger-UI für die automatische Dokumentation. Ich habe versucht den link :- https://github.com/zircote/swagger-php Auch habe ich versucht zu umgehen mit der

Mit Swagger mit WCF REST

Anzahl der Antworten 3 Antworten
Ich habe einen WCF-REST-basierte service-das möchte ich hinzufügen-Gehabe. Habe ich installiert Swagger.NET Paket, mein Projekt verwenden .NET 4.0. Ich habe auch ermöglicht, XML-Dokumente, etc... aber jetzt bin ich nicht sicher der beste Weg von hier. Wenn ich

Warum ist der swagger-ui nicht mit meinen kommentierten REST-Methoden?

Anzahl der Antworten 2 Antworten
Ich habe Probleme beim konfigurieren von swagger zu sehen, wie meine REST-Methoden. Ich arbeite in Eclipse und Tomcat 7. Ich habe die folgende einfache REST-Methode/Klasse: package com.rest; import javax.ws.rs.GET; import javax.ws.rs.Path; import com.wordnik.swagger.annotations.Api; import com.wordnik.swagger.annotations.ApiOperation; @Api( value="/",

REST-API - Swagger + Java + Jersey falsche Liste Weg und zusätzliche apis

Anzahl der Antworten 2 Antworten
In meinem Projekt bin ich mit Maven, Jetty, Swagger, Java und Jersey für die Erstellung von REST-API. Ich benutze auch Swagger zu erstellen gut aussehende Dokumentation für mein API. Fast alles ok ist, statt drei Punkte. Bei

so integrieren Sie stolzieren mit meiner express-Anwendung

Anzahl der Antworten 4 Antworten
Immer ich verwendet, um meine Knoten side services zu einigen anderen teams mit der richtigen Dokumentation. Basierend auf dieser Dokumentation werden Sie meine Dienste nutzen. Bezüglich dieser, wenn ich Sprach mit einigen anderen Kerl. Er schlug mich

swagger Feld Datum vs-Datum-Uhrzeit-Feld

Anzahl der Antworten 2 Antworten
Ich bin mit swagger zu testen, meine rest-api, eine der Eigenschaft meiner Person-Klasse ist ein Datumsfeld aus, das ich benötige das Datum im yyyy-mm-dd-format , aber swagger Modell schema zeigt dieses Feld als Datum-Zeit statt date-Feld, also

Swagger-UI - "TypeError: Failed to fetch" auf gültige Antwort

Anzahl der Antworten 4 Antworten
Ich habe gerade nach unten gezogen die neueste Fors aus dem Git-repo (3.0.19) mit: https://github.com/swagger-api/swagger-ui.git und aktualisiert meine API für die neue version. Lief git describe --tags zu bestätigen und meine version ist derzeit: v3.0.19-6-gaab1403 Das problem

Immer Keine 'Access-Control-Allow-Origin' mit Swagger und Vorarbeiter Rails server

Anzahl der Antworten 2 Antworten
Ich habe mein server läuft auf 0.0.0.0:5100. Wenn ich versuche, auf mein Swagger docs, bekomme ich die folgende Fehlermeldung in der Konsole: XMLHttpRequest cannot load http://0.0.0.0/api/v1/types.json. No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin 'http://0.0.0.0:5100'

Web-Api zum hinzufügen einer Header-parameter für alle API in Fors

Anzahl der Antworten 4 Antworten
Suchte ich nach Möglichkeiten zum hinzufügen von ein Anfrage-header-parameter werden würden automatisch Hinzugefügt, um jede Methode, die in meinem web-api finden konnte ich aber nicht klar. Beim suchen habe ich festgestellt, dass die Methode OperationFilter() hat, etwas

Konfigurieren von Swagger UI, Jersey und Datei-upload?

Anzahl der Antworten 2 Antworten
Ich habe eine Jersey-Dienst mit einem Datei-upload-Methode sieht wie folgt aus (vereinfacht): @POST @Path("/{observationId : [a-zA-Z0-9_]+}/files") @Produces({ MediaType.APPLICATION_JSON}) @Consumes(MediaType.MULTIPART_FORM_DATA) @ApiOperation( value = "Add a file to an observation", notes = "Adds a file to an observation and