# Integração institucional sem expor arquitetura interna.

Referência segura para parceiros, hospitais e lideranças que querem consumir métricas, TAT, achados críticos e auditoria fora do dashboard.

Canonical host: docs.laudos.ai

## API institucional

A API pública v1 permite que lideranças autorizadas leiam um snapshot operacional da própria organização via chave institucional.

- GET /api/v1/organizations/{orgIdOrSlug}/dashboard?days=30&limit=50
- Header: Authorization: Bearer <api_key>
- Permissão necessária: organizations

## Dados retornados

O snapshot inclui apenas dados autorizados da organização solicitada, em formato pronto para BI, portal interno ou dashboard de parceiro.

- Membros, máscaras, volume de laudos e janela de análise.
- TAT agregado e por usuário, quando rastreado.
- Achados críticos, status de comunicação e auditoria recente.

## Limites de segurança

A documentação pública não revela prompts, provedores, modelos, tabelas, infraestrutura, segredos ou casos privados. A integração usa contratos de produto.

- Chaves são geradas no painel de desenvolvedor por usuários autorizados.
- Acesso e rate limit são auditáveis por chave.
- Standard members não devem receber leitura institucional ampla.

## Domínio de docs

Aponte docs.laudos.ai para esta aplicação no Vercel e use /pt-BR/docs como rota canônica. Para manual de usuário, aponte manual.laudos.ai para /pt-BR/manual.

- Configure os aliases no projeto da landing.
- Mantenha /docs.md e /manual.md como versões Markdown para importadores autorizados.
- Revise o conteúdo antes de compartilhar com parceiros.