Este é o cenário: Uma empresa vai oferecer informações sob o formato de imagens e caracteres e htmls-iframes (cupons, roupas, produtos) para que os seus clientes (lojas, atacadistas, varegistas, etc) insiram nos seus websites. Ou seja, além de dados existem algumas regras de negócios, imagens de produtos de cada cliente, (o cliente quer exibir o sabonete X de uma maneira e o cliente B quer que a imagem do sabonete X seja de outra maneira.)
A minha abordagem é a criação de uma api que vai oferecer os endpoints para os seus clientes.
A API será RESTful, por isso estava fazendo uma pesquisa nesse post para entender melhor sobre boas práticas de construção de APIs..
Aminha dúvida é em relação a operacionalização desse serviço. Onde colocar as regras de negócio? Dentro da API?
No meu entendimento a API, no fim das contas deveria trabalhar, somente como uma interface que oferece acesso ao banco de dados, servindo end-points para fazer as operações CRUD, e retornando respostas JSON, somente.
Mas os cleintes precisam de alguns objetos iframes, ou seja, precisam dos dados que restornam do banco de dados e mais alguns elementos HTML ou imagens.
Entao aqui está a minha dúvida. A API deveria retornar HTML? Isso é uma boa prática? Vai ser legal para a posterior manuntenção? Ou seja deveríamos seguir o caminho verde do desenho abaixo ou ir direto para a API (caminho laranja)?
Nesse caso o caminho verde é ser criado um serviço que iria consumir os endpoints da API e nele poderíamos inserir as regras de negócio e os HTMLs. Nesse cenário esse serviço (Microserviço?) não seria uma API mas estaria agindo como uma, pois para o cliente 1 ou 2 eles só precisariam desses end-points para ser usado no seus web sites.