Conectar
Olá, desenvolvedor aventureiro! Se você está lendo este texto, quer dizer que gostou de nossos sistemas e deseja usufruir das melhores coisas que eles têm a oferecer. Isso é uma ótima notícia para nós!
Todos os nossos sistemas são livres e de código aberto, e ficamos felizes pois você deseja fazer a integração às nossas tecnologias. E melhor: fazemos questão de ajudar você neste processo ;).
Neste guia, iniciaremos a sua jornada para que possa realizar essa conexão da melhor forma possível. Continue lendo as próximas seções para descobrir os macetes e as formas que preparamos especialmente para você, e esperamos que dê tudo certo!
De quais modos os serviços podem ser utilizados?
Os nossos sistemas foram projetados para serem pequenos componentes que podem operar em conjunto ou de maneira individual, sem restrição à arquitetura que planejamos implantar para a nossa utilização.
A nossa intenção é de fornecer as funcionalidades individuais, caso você queira um recurso específico, e também de fornecer um sistema integrado que cuida de toda essa interação por você.
Dessa forma, queremos que você possa usufruir do sistema como um todo ou de funcionalidades específicas, e que isso aconteça de maneira mais simples e satisfatória possível.
Web API Integrada
O serviço Web API Integrada do Ladesa garante a utilização conjunta em um único canal de comunicação o acesso todas as funcionalidades do sistema que, dentre todas elas, incluem o recurso de autenticação, geração de horário e as funcionalidades pertinites a gestão dos recursos do sistema.
Ao utilizar a Web API Integrada, você pode focar no charme da interface visual e da experiência que os seus usuários terão ao utilizar as funcionalidades que fornecemos.
Diagrama que demonstra a arquitetura interação geral entre os usuários finais e os sistemas do projeto por meio da Web API Integrada. Continue lendo em nossa seção dedicada a Web API Integrada.
Recursos Individuais
Algo muito útil e poderoso é a utilização de recursos individuais que satisfaçam os seus interesses e necessidades, e por isso ficamos felizes em anunciar que você pode utilizar as pequenas funcionalidades de nosso sistema e integrar a sua plataforma já existente.
Os recursos individuais disponíveis para integração incluem:
- Autenticação (Keycloak) — SSO via OpenID Connect / OAuth 2.0 para autenticar usuários da sua aplicação com as mesmas credenciais do Ladesa;
- Gestão Acadêmica — endpoints REST para consultar e manipular dados de cursos, turmas, disciplinas, professores e alunos;
- Geração de Horário — endpoint para solicitar geração de grades de horário e consultar o status/resultado;
- Gestão de Ambientes (SISGEA) — endpoints para consultar disponibilidade de salas e realizar reservas.
A documentação detalhada de cada recurso individual será publicada conforme os contratos de API forem estabilizados. Consulte os contratos TypeSpec para a especificação técnica atual.