Api-blueprint: ¿APIARY permite múltiples hosts en el mismo proyecto?

También tengo curiosidad por esto. Estamos utilizando múltiples entornos de prueba y poder alternar entre ellos para encontrar diferencias es fundamental.

Actualmente no estamos respaldando esto, pero estamos trabajando en soluciones que lo harán posible en el futuro.

¿Algún avance en esto?

¿Existe ya alguna solución a este problema?

No uno público; Hacemos una lluvia de ideas sobre cómo resolver este problema y no estamos seguros de que varios HOST sean la solución correcta, en lugar de desacoplar las preocupaciones de diseño e implementación.

@Almad Describiré mi caso de uso para dar algunos comentarios con respecto a este problema.

Nuestro caso de uso de Apiary es simplemente incrustar documentación bonita en nuestro panel de desarrollador. No estamos planeando utilizar ninguna funcionalidad, complementos o extensiones adicionales en este momento. Usamos múltiples subdominios para diferentes partes de nuestro sistema (microservicios), por ejemplo, autenticación, facturación, estadísticas, recuperación de recursos, etc. Como puede ver, cada subdominio es responsable de un dominio diferente.

Lo que parece más atractivo de Apiary es la funcionalidad de la consola. Puede describir los puntos finales y los usuarios finales pueden experimentar con ellos a través de la consola. También agrega una opción para cambiar idiomas y copiar código de ejemplo en diferentes idiomas.

Sin embargo, sin una opción para usar varios subdominios, solo nos quedan algunas opciones:

• Utilice un documento diferente por microservicio. Pero luego la documentación está esparcida por el lugar. Es difícil de seguir. Y la vinculación entre ellos no es trivial.
• No utilice la referencia en absoluto. Oculte la consola mientras incrusta la documentación. El inconveniente es, por supuesto, no mostrar la consola. Entonces, me quedo pensando en la siguiente viñeta:
• La documentación de la API de construcción diseñamos nosotros mismos sin utilizar terceros.

Ninguna de las opciones parece genial. ¿Alguna recomendación para nuestro caso?

Habrá una solución para eso, pero desafortunadamente no puedo hablar sobre eso y dar plazos porque la SEC y los abogados :(

¿El futuro previsible daría suficientes esperanzas?

¿Hay algún avance?

Se ha agregado soporte para el objeto host en los elementos de la API principalmente para admitir el mapeo de objetos del servidor OAS3. Esté atento a las https://help.apiary.io/tools/interactive-documentation-v4/ actualizaciones del renderizador.

Sin embargo, no he visto ningún progreso para el soporte en API Blueprint.