Apicurio-studio: Erreur de page non trouvée lors de la tentative d'ouverture d'un modèle existant à partir de github.

Salut merci pour le retour. Malheureusement, pour le moment, Apicurio ne prend pas en charge la lecture/l'écriture de YAML (comme vous l'avez découvert). Il y a une demande de fonctionnalité pour cela ici:

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

Ce n'est pas difficile à faire, mais il y a quelques autres améliorations avant celle-là dans la file d'attente. :)

Comme solution de contournement, vous pouvez essayer de convertir de YAML en JSON, de stocker le résultat dans GitHub, puis de l'ouvrir. Ennuyeux je sais, mais cela fonctionnerait jusqu'à ce que nous puissions obtenir des fonctionnalités supplémentaires dans apicurio.

Remarque : il s'agit toujours d'un rapport de bogue valide car nous avons besoin de meilleurs messages d'erreur lors de l'ajout/l'importation d'une API. Si la ressource est introuvable (par exemple lors d'une importation à partir d'une URL), nous devons le signaler ( ne pas signaler une erreur "Page non trouvée"). Si la ressource existe mais est dans un format incorrect, nous devons le signaler différemment.

Je n'ai pas pu faire fonctionner mon OpenAPI 3 JSON ou l'exemple lié ci-dessus aujourd'hui. L'importation à partir d'une URL n'a pas fonctionné pour :

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

ou

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

Salut @david4096 - la première URL échoue car il n'y a vraiment aucun contenu à cette URL. Au moins, lorsque je clique sur ce lien, il n'y a pas de fichier. En fait, il n'y a pas resources dossier src/test pour ce module :

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

Cependant, il y a évidemment du contenu à la deuxième URL. La raison pour laquelle cela ne fonctionne pas dans Apicurio est que nous ne prenons malheureusement pas encore en charge l'extraction de contenu à partir de branches (uniquement master). Il s'agit clairement d'une fonctionnalité manquante, car il n'est pas difficile de prendre en charge les branches.

Cela dit, je pense que nous allons dans le sens de la possibilité d'ajouter/importer une conception d'API à partir d'une URL arbitraire au lieu des différents systèmes de contrôle de source via leurs API respectives (ce que nous faisons maintenant, purement comme un sursis à partir du moment où nous nous sommes davantage appuyés sur ces systèmes pour stocker les données). Je vais augmenter la priorité de la fonctionnalité "Importer depuis l'URL" et l'inclure dans la prochaine version.

Pour l'instant, ce que vous pouvez faire comme solution de contournement est de stocker toutes les API que vous souhaitez ajouter/importer dans la branche principale de n'importe quel référentiel github (peut-être créer un référentiel à cet effet) et importer à partir de là.

J'ai ajouté un ticket pour prendre en charge les branches dans le contrôle de source :

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

Cependant, je pense que l'importation de contenu à partir d'une URL arbitraire sera une fonctionnalité plus utile, je vais donc aborder cela en premier.

Salut @EricWittmann merci pour l'explication !