Num projeto Apidog, você pode utilizar módulos para organizar os seus endpoints. Um módulo é semelhante a um "serviço" na arquitetura técnica, concebido para o ajudar a gerir e apresentar endpoints de forma mais eficiente — especialmente em sistemas baseados em microsserviços. Cada módulo inclui o seu próprio conjunto de endpoints relacionados, componentes (tais como schemas, respostas e esquemas de segurança) e URLs de base (uma para cada ambiente).Cada módulo corresponde a um ficheiro de especificação Swagger/OpenAPI completo e independente.
Utilize módulos para organizar os seus endpoints quando:
Serviços estreitamente relacionados: Por exemplo, num projeto de IA: um módulo para endpoints de geração de texto, outro para endpoints de geração de imagens e outro para endpoints de fala.
Microsserviços: Por exemplo, num projeto de comércio eletrónico, poderá ter serviços de autenticação, encomendas e produtos.
Múltiplas versões de API: Por exemplo, o seu projeto expõe diferentes versões da API a utilizadores externos, tais como Legacy, LTS e Latest.
No projeto, passe o cursor sobre a parte superior da árvore de pastas e clique no botão +. No menu pendente, selecione Novo Módulo.
2
Introduza o nome do módulo e clique em Guardar. O novo módulo aparecerá na árvore de pastas. Clique no módulo para ver os respetivos detalhes, incluindo:
Estatísticas de dados dos recursos no módulo
Cobertura de casos de endpoint e cenários de teste
Opções de exportação para endpoints no módulo
Definições da fonte de dados
Variáveis do módulo – semelhantes às variáveis de ambiente, mas acessíveis apenas nos pedidos de endpoint deste módulo.
Assim que um módulo é criado, este aparecerá automaticamente na página de Gestão de Ambientes. Você pode atribuir uma URL de Base a cada ambiente dentro do módulo recém-adicionado.
Por predefinição, os pedidos de endpoint de cada módulo utilizarão automaticamente a URL de Base definida para esse módulo no ambiente atual, combinada com o caminho do endpoint. Os endpoints de um módulo não podem utilizar a URL de Base de outro módulo para enviar pedidos.
Padrão de Utilização Legado
Se um único módulo contiver vários serviços (múltiplas URLs de Base), você pode especificar manualmente qual URL de Base utilizar ao nível da pasta ou do endpoint dentro do módulo.No entanto, esta abordagem fazia parte de um padrão de utilização mais antigo no Apidog e não é recomendada desde a versão 2.7.16. Em vez disso, sugerimos dividir os serviços em módulos separados, cada um com a sua própria URL de Base.Saiba mais: Ambientes e serviços