Api-blueprint: APIARY autorise-t-il plusieurs hôtes dans le même projet

Aussi curieux à ce sujet. Nous utilisons plusieurs environnements de test et il est essentiel de pouvoir basculer entre eux pour trouver des différences.

Nous ne soutenons pas cela actuellement, mais nous travaillons sur des solutions qui rendront cela possible à l'avenir.

Une mise à jour pour ceci?

Existe-t-il déjà des solutions à ce problème ?

Pas un public ; nous réfléchissons à la manière de résoudre ce problème et nous ne sommes pas sûrs que plusieurs HOST soient la bonne solution, par opposition au découplage des problèmes de conception et de déploiement.

@Almad Je vais décrire mon cas d'utilisation pour donner des commentaires sur ce problème.

Notre cas d'utilisation Apiary intègre purement une jolie documentation à notre tableau de bord de développeur. Nous ne prévoyons pas d'utiliser de fonctionnalités, de plugins ou d'extensions supplémentaires pour le moment. Nous utilisons plusieurs sous-domaines pour différentes parties de notre système (micro services), par exemple, l'authentification, la facturation, les statistiques, la récupération des ressources, etc. Comme vous pouvez le voir, chaque sous-domaine est responsable d'un domaine différent.

Ce qui semble le plus attrayant à propos d'Apiary, c'est la fonctionnalité de la console. Vous pouvez décrire les points de terminaison et les utilisateurs finaux peuvent les tester via la console. Il ajoute également une option pour changer de langue et copier un exemple de code dans différentes langues.

Cependant, sans possibilité d'utiliser plusieurs sous-domaines, il ne nous reste que quelques options :

• Utilisez un document différent par micro-service. Mais ensuite, la documentation est éparpillée un peu partout. C'est difficile à suivre. Et lier entre eux n'est pas anodin.
• N'utilisez pas du tout la référence. Masquez la console lors de l'intégration de la documentation. L'inconvénient est bien sûr de ne pas afficher la console. Ensuite, il me reste à penser au prochain point :
• Construire la documentation de l'API nous-mêmes concevons sans utiliser de tiers.

Aucune des options ne semble géniale. Une recommandation à notre cas?

Il y aura une solution pour cela, mais malheureusement je ne peux pas en parler et donner des délais car la SEC et les avocats :(

Un avenir prévisible donnerait-il suffisamment d'espoir ?

y at-il des progrès?

La prise en charge de l'objet host a été ajoutée dans les éléments d'API principalement pour prendre en charge le mappage d'objet serveur OAS3. Restez à l'écoute des https://help.apiary.io/tools/interactive-documentation-v4/ mises à jour du moteur de rendu.

Cependant, je n'ai vu aucun progrès pour la prise en charge de l'API Blueprint.