Api-blueprint: Apakah APIARY mengizinkan Banyak Host dalam proyek yang sama

Juga ingin tahu tentang ini. Kami menggunakan beberapa lingkungan pengujian dan kemampuan untuk beralih di antara mereka untuk menemukan perbedaan sangat penting.

Saat ini kami tidak mendukung hal ini, tetapi kami sedang mengerjakan solusi yang memungkinkan hal ini di masa mendatang.

Ada pembaruan tentang ini?

Apakah sudah ada solusi untuk masalah ini?

Bukan milik publik; kami melakukan brainstorming tentang bagaimana memecahkan masalah ini dan kami tidak yakin beberapa HOST adalah solusi yang tepat, sebagai lawan dari masalah desain dan penerapan decoupling.

@Almad Saya akan menjelaskan kasus penggunaan saya untuk memberikan umpan balik sehubungan dengan masalah ini.

Kasus penggunaan Apiary kami murni menyematkan dokumentasi cantik ke dasbor pengembang kami. Kami tidak berencana menggunakan fungsionalitas, plugin, atau ekstensi tambahan apa pun saat ini. Kami menggunakan beberapa subdomain untuk bagian yang berbeda dari sistem kami (layanan mikro), misalnya, otentikasi, penagihan, statistik, pengambilan sumber daya, dll. Seperti yang Anda lihat, setiap subdomain bertanggung jawab untuk domain yang berbeda.

Apa yang tampaknya paling menarik tentang Apiary adalah fungsionalitas konsol. Anda dapat menjelaskan titik akhir dan pengguna akhir dapat bereksperimen dengannya melalui konsol. Itu juga menambahkan opsi untuk mengubah bahasa dan menyalin kode contoh dalam bahasa yang berbeda.

Namun, tanpa opsi untuk menggunakan beberapa subdomain, kami hanya memiliki beberapa opsi:

• Gunakan dokumen yang berbeda per layanan mikro. Namun kemudian dokumentasinya berserakan di mana-mana. Sulit untuk diikuti. Dan menghubungkan di antara mereka bukanlah hal yang sepele.
• Tidak menggunakan referensi sama sekali. Sembunyikan konsol saat menyematkan dokumentasi. Kekurangannya tentu saja tidak menampilkan console. Kemudian, saya dibiarkan memikirkan poin-poin berikutnya:
• Membangun desain dokumentasi API sendiri tanpa menggunakan pihak ke-3.

Tak satu pun dari opsi yang tampak hebat. Adakah rekomendasi untuk kasus kami?

Akan ada solusi untuk itu, tapi sayangnya saya tidak bisa membicarakannya dan memberikan timeline karena SEC dan pengacara :(

Akankah masa depan yang dapat diperkirakan memberikan harapan yang cukup?

apakah ada kemajuan?

Dukungan untuk objek host telah ditambahkan dalam elemen API terutama untuk mendukung pemetaan Objek Server OAS3. Nantikan https://help.apiary.io/tools/interactive-documentation-v4/ pembaruan penyaji.

Saya belum melihat kemajuan apa pun untuk dukungan di API Blueprint.