HTTP e REST
Uma interface que aceita requisições HTTP não segue necessariamente todas as restrições de REST. O protocolo de comunicação não basta para classificar a arquitetura.
Tecnologia
API RESTful
O que é API RESTful?
API RESTful é interface entre sistemas orientada pelo estilo arquitetural REST, que organiza a interação com recursos por uma interface uniforme.
Por que esse conceito importa na clínica
Uma API pode permitir que sistemas troquem informações sem digitação repetida. O rótulo RESTful, sozinho, não informa quais dados estão disponíveis, quem pode acessá-los ou quanto a integração custa. Essas condições precisam estar documentadas e ser demonstradas para o fluxo desejado.
Exemplo aplicado
Em um exemplo hipotético, a clínica quer consultar os horários livres em outro sistema. A equipe confere se há uma operação documentada para essa consulta, qual credencial pode utilizá-la e como interpretar respostas vazias ou erros. Depois testa o fluxo com dados fictícios, sem pressupor que também será possível criar agendamentos.
Pontos-chave
- REST é um estilo arquitetural; não é uma certificação de integração pronta.
- Entre suas restrições estão cliente-servidor, interface uniforme, comunicação sem estado de sessão no servidor e regras de cache.
- Recursos são manipulados por representações; JSON é um formato possível, não a definição de REST.
- Na contratação, confirme operações, permissões, limites de uso, versionamento e suporte.
Não confunda
API e integração pronta
Disponibilizar uma API oferece uma interface. Conectar dois produtos ainda pode exigir desenvolvimento, configuração, testes e manutenção.
Perguntas relacionadas
Uma API RESTful dispensa autenticação?
Não. O estilo arquitetural não concede acesso público aos dados. As permissões e o mecanismo de autenticação dependem do contrato da API.
Como saber se a API atende à minha clínica?
Escolha uma tarefa concreta, como consultar disponibilidade, e peça documentação e demonstração dessa operação. Verifique também o que acontece com erros, mudanças de versão e limites de requisições.
Fontes e revisão
Conteúdo escrito por Equipe Lumave, Produto e Tecnologia. Última revisão em .
Termos relacionados
FHIR R4
Fast Healthcare Interoperability Resources — padrão internacional para troca de dados de saúde entre sistemas
Webhook
Mecanismo em que um sistema envia uma notificação HTTP a um endereço configurado quando ocorre um evento acompanhado
SaaS
Software como serviço: modelo em que o cliente utiliza aplicações operadas pelo fornecedor em infraestrutura de nuvem, por navegador ou outra interface
Gerencie sua clínica de estética com o Lumave
Prontuário, agenda e financeiro em uma plataforma
Teste grátis 14 dias