Azure-API-Verwaltungsdienst erkennt Swagger nicht

Ich versuche, den Azure-API-Verwaltungsdienst zu verwenden.Azure-API-Verwaltungsdienst erkennt Swagger nicht

Wenn ich auf Import API gehe, erhalte ich den Fehler unten.

One or more fields contain incorrect values: 
Parsing error(s): Unexpected character encountered while parsing value: #. Path '', line 0, position 0. 
One or more fields contain incorrect values: 
API not found

Das passiert, wenn ich meine Swagger-Spezifikation hochlade. Dies ist das erste Mal, dass ich es schreibe, aber ich habe mein Dokument durchgesehen und finde keine Probleme damit.

Ich habe dieses Dokument auch an anderer Stelle verwendet und es hat gut funktioniert.

http://pastebin.com/fb4xiuLu Ein Link zu meiner Prahlerei Dokumentation

Jede Hilfe sehr geschätzt würde. Danke :)

Quelle

2017-01-22 magna_nz

Versuchen Sie, Ihre Swagger-Dokumentation im JSON-Format hochzuladen. – mikalai

BTW, Ihre Spezifikation ist keine gültige Swagger-Spezifikation. 1) Mehrere Typen wie 'type: ['integer', 'null']' sind [nicht unterstützt] (https://github.com/OAI/OpenAPI-Specification/issues/458); 'type' erfordert einen einzelnen Typ. 2) "null" ist kein gültiger Typ, weil es nicht [in der Spezifikation aufgeführt] ist (https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types). Aber es gibt eine [Diskussion im OpenAPI-Spezifikationsrepo] (https://github.com/OAI/OpenAPI-Specification/issues/229), um die "Nullwert" -Unterstützung in der nächsten Version der Spezifikation 3.0 hinzuzufügen. – Helen

Wie mikalai erwähnt, dass wir Datei mit Json-Format importieren müssen. Wir könnten weitere Informationen über den Import von API erhalten, siehe die offizielle document. Holen Sie sich einige aus dem Dokument geschnippt.

Die API-Verwaltung unterstützt derzeit sowohl die 1.2- als auch die 2.0-Version des Swagger-Dokuments für den Import. Stellen Sie sicher, dass Ihr Swagger 2.0-Dokument diese Eigenschaften enthalten muss, obwohl Swagger 2.0 specification deklariert, dass Host-, BasePath- und Schemaparameter optional sind. Andernfalls wird es nicht importiert.

Demo Swagger JSON-Datei finden Sie unter calapijson.

Quelle

2017-01-23 08:58:51

ich verstehe nicht ganz - Sie erwähnen, dass host basePath und Schemen Eigenschaften erforderlich sind - aber nur basePath zeigt sich in Ihrer Demo-Datei. Außerdem kann ich in der Swagger-Spezifikation kein Schema oder Host-Beispiel finden. Was vermisse ich? – ASX

Azure-API-Verwaltungsdienst erkennt Swagger nicht

Antwort

Verwandte Themen