Apicurio-studio: Fehler "Seite nicht gefunden" beim Versuch, ein vorhandenes Modell von github zu öffnen.

Hallo danke für die Rückmeldung. Leider unterstützt Apicurio derzeit nicht das Lesen/Schreiben von YAML (wie Sie festgestellt haben). Dafür gibt es hier eine Feature-Anfrage:

https://github.com/Apicurio/apicurio-studio/issues/165

Es ist nicht schwer, aber es gibt noch ein paar andere Verbesserungen in der Warteschlange. :)

Als Workaround können Sie versuchen, von YAML in JSON zu konvertieren, das Ergebnis in GitHub zu speichern und dann zu öffnen. Ärgerlich, ich weiß, aber das würde funktionieren, bis wir zusätzliche Funktionen in apicurio bekommen können.

Hinweis: Dies ist immer noch ein gültiger Fehlerbericht, da wir beim Hinzufügen/Importieren einer API bessere Fehlermeldungen benötigen. Wenn die Ressource nicht gefunden werden kann (zB beim Importieren von einer URL), sollten wir dies melden ( keinen "Seite nicht gefunden"-Fehler melden). Wenn die Ressource vorhanden ist, aber ein falsches Format hat, sollten wir dies anders melden.

Ich konnte meine OpenAPI 3 JSON oder das oben verlinkte Beispiel heute nicht zum Laufen bringen. Das Importieren von einer URL funktionierte nicht für:

https://github.com/Apicurio/apicurio-studio/blob/master/back-end/hub-api/src/test/resources/io/apicurio/hub/api/beans/simple-api-3.0.json

oder

https://github.com/david4096/data-object-schemas/blob/openapi3/openapi/data_objects_service.openapi.json

Hallo @david4096 - die erste URL resources innerhalb von src/test für dieses Modul:

https://github.com/Apicurio/apicurio-studio/tree/master/back-end/hub-api/src/test

Unter der zweiten URL befindet sich jedoch offensichtlich Inhalt. Der Grund, warum es in Apicurio nicht funktioniert, ist, dass wir das Einziehen von Inhalten aus Branches (nur Master) leider noch nicht unterstützen. Dies ist eindeutig eine fehlende Funktionalität, da es nicht schwierig ist, Verzweigungen zu unterstützen.

Trotzdem denke ich, dass wir in der Lage sind, ein API-Design von einer beliebigen URL hinzuzufügen / zu importieren, anstatt von den verschiedenen Quellcodeverwaltungssystemen über ihre jeweiligen APIs (was wir jetzt nur als Überbleibsel tun) ab, als wir uns stärker auf diese Systeme zur Speicherung der Daten stützten). Ich werde die Priorität der Funktion "Von URL importieren" erhöhen und in die nächste Version aufnehmen.

Im Moment können Sie als Workaround alle APIs, die Sie hinzufügen/importieren möchten, im Master-Zweig eines beliebigen Github-Repositorys speichern (möglicherweise zu diesem Zweck ein Repository erstellen) und von dort importieren.

Ich habe ein Ticket hinzugefügt, um Branches in der Quellcodeverwaltung zu unterstützen:

https://github.com/Apicurio/apicurio-studio/issues/222

Ich denke jedoch, dass das Importieren von Inhalten von einer beliebigen URL eine nützlichere Funktion sein wird, also werde ich zuerst darauf eingehen.

Hallo @EricWittmann danke für die Erklärung!