> ## Documentation Index
> Fetch the complete documentation index at: https://docs-visuolab.levantelab.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrações e API

> Referências da API, documentação técnica e orientações para planejar integrações institucionais com o VisuoLab.

Esta página reúne referências para equipes de tecnologia e desenvolvimento que desejam conhecer os recursos técnicos do VisuoLab e **avaliar integrações com sistemas institucionais**.

<Note>
  A documentação da API e parte dos materiais técnicos estão publicados externamente, em inglês. Antes de implementar uma integração, confirme a versão em uso e a disponibilidade dos recursos com a equipe responsável pela instalação.
</Note>

## Documentação disponível

<CardGroup cols={2}>
  <Card title="Referência da API do VisuoLab" icon="code" href="https://api-visuolab.levantelab.com.br/docs/en#description/introduction">
    Consulte a documentação oficial da API para explorar os recursos e operações descritos na versão disponível. Ela é a referência para avaliar as possibilidades técnicas de integração.
  </Card>

  <Card title="Documentação técnica complementar" icon="book-open" href="https://visuolab.levantelab.com.br/en/documentation">
    Acesse os materiais técnicos publicados no site do VisuoLab. Utilize-os como referência complementar às orientações de implantação desta documentação.
  </Card>
</CardGroup>

## Antes de iniciar uma integração

Uma integração deve considerar não apenas o que a API documenta, mas também as particularidades da instalação institucional.

<Steps>
  <Step title="Defina o objetivo">
    Identifique os fluxos e dados que precisam ser integrados, quem utilizará a solução e quais resultados são esperados.
  </Step>

  <Step title="Confira os recursos documentados">
    Consulte a referência da API para verificar se as operações necessárias estão disponíveis na versão utilizada pela instituição.
  </Step>

  <Step title="Alinhe acesso, permissões e proteção de dados">
    Confirme com a equipe técnica as regras aplicáveis de autenticação, autorização, tratamento de informações pessoais e uso de ambientes de teste.
  </Step>

  <Step title="Valide antes de utilizar em produção">
    Planeje testes de integração, tratamento de falhas, monitoramento e manutenção conforme a implantação institucional.
  </Step>
</Steps>

## Instalação e operação

Para conhecer a infraestrutura, os serviços e as etapas de implantação, consulte [Instalação e configuração técnica](/pt-BR/installation).

Se sua instituição planeja disponibilizar uma integração, alinhe previamente os requisitos com sua equipe técnica e, quando necessário, com a [Levante Lab](mailto:contato@levantelab.com.br).

## Evolução desta documentação

Nesta primeira etapa, mantemos as referências técnicas externas como fontes de consulta. Futuramente, poderemos reunir a documentação de endpoints no próprio Mintlify, **caso exista uma especificação OpenAPI compatível e aprovada para publicação**, com a devida revisão de versões, exemplos e requisitos de acesso.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.