Api-blueprint: Erlaubt APIARY mehrere Hosts im selben Projekt?

Auch neugierig darauf. Wir verwenden mehrere Testumgebungen und die Möglichkeit, zwischen ihnen zu wechseln, um Unterschiede zu finden, ist entscheidend.

Wir unterstützen dies derzeit nicht, arbeiten aber an Lösungen, die dies in Zukunft ermöglichen.

Gibt es hierzu Neuigkeiten?

Gibt es schon Lösungen für dieses Problem?

Kein öffentlicher; Wir machen Brainstorming zur Lösung dieses Problems und sind uns nicht sicher, ob mehrere HOSTs die richtige Lösung sind, im Gegensatz zur Entkopplung von Design- und Bereitstellungsproblemen.

@Almad Ich werde meinen Anwendungsfall beschreiben, um Feedback zu diesem Problem zu geben.

Unser Anwendungsfall Apiary besteht darin, eine hübsche Dokumentation in unser Entwickler-Dashboard einzubetten. Wir planen derzeit keine zusätzlichen Funktionen, Plugins oder Erweiterungen zu verwenden. Wir verwenden mehrere Subdomains für verschiedene Teile unseres Systems (Mikrodienste), zum Beispiel Authentifizierung, Abrechnung, Statistik, Ressourcenabruf usw. Wie Sie sehen, ist jede Subdomain für eine andere Domain verantwortlich.

Was an Apiary am attraktivsten erscheint, ist die Konsolenfunktionalität. Sie können Endpunkte beschreiben und Endbenutzer können mit ihnen über die Konsole experimentieren. Es fügt auch eine Option hinzu, um Sprachen zu ändern und Beispielcode in verschiedene Sprachen zu kopieren.

Ohne die Möglichkeit, mehrere Subdomains zu verwenden, bleiben uns jedoch nur wenige Optionen:

• Verwenden Sie für jeden Mikrodienst ein anderes Dokument. Aber dann ist die Dokumentation über den Ort verstreut. Es ist schwer zu folgen. Und die Verknüpfung zwischen ihnen ist nicht trivial.
• Verwenden Sie die Referenz überhaupt nicht. Blenden Sie die Konsole aus, während Sie die Dokumentation einbetten. Der Nachteil ist natürlich, dass die Konsole nicht angezeigt wird. Dann denke ich an den nächsten Aufzählungspunkt:
• Erstellen von API-Dokumentationen selbst entwerfen, ohne Drittanbieter zu verwenden.

Keine der Optionen scheint großartig zu sein. Irgendeine Empfehlung für unseren Fall?

Es wird eine Lösung dafür geben, aber ich kann leider nicht darüber sprechen und Termine nennen, da SEC und Anwälte :(

Würde die absehbare Zukunft genügend Hoffnung geben?

Gibt es irgendeinen Fortschritt?

Unterstützung für host Objekte wurde in API-Elementen in erster Linie https://help.apiary.io/tools/interactive-documentation-v4/ Renderer-Updates.

Ich habe jedoch keine Fortschritte bei der Unterstützung von API Blueprint gesehen.