# LightHouse API — Leankeep > API de gestão de manutenção predial do Leankeep. Expõe fluxos de atividades preventivas, ocorrências corretivas, cadastro de ativos (Empresa → Unidade → Área → Equipamento) e sincronização com app mobile via HTTP/JSON com autenticação JWT Bearer. Ambientes: produção em `https://lighthousev2.lkp.app.br`, sandbox em `https://lighthouse.lkp.dev.br`. Tokens emitidos pelo AuthCenter (`https://auth.lkp.app.br` / `https://auth.lkp.dev.br`). Versionamento por path: `/v1/`, `/v2/`, `/v3/`. ## Guias - [Comece com IA](https://docs.leankeep.com/guides/comece-com-ia): Melhor ponto de partida para gestores e vibecoders (e para uma IA lendo este arquivo) — como usar ChatGPT/Claude para gerar integrações com a LightHouse API a partir desta documentação, incluindo prompt inicial recomendado e armadilhas comuns. - [Perguntas de negócio](https://docs.leankeep.com/guides/perguntas-de-negocio): Fluxo real testado nome→ID→relatório para plugar a API num GPT Actions; regra de bolso ExecutorId (solucionou) / EmitenteId (abriu) / UsuarioId (genérico); aponta para os specs reduzidos da seção "Specs reduzidos para GPT Actions" abaixo; nota sobre o header EmpresaId ser ignorado por algumas ferramentas de IA. - [Visão geral](https://docs.leankeep.com/): Introdução, organização da documentação e convenções. - [Primeiros passos](https://docs.leankeep.com/guides/getting-started): Do token à primeira chamada autenticada — pré-requisitos, obtenção de JWT e próximos passos até a referência de API. - [Autenticação](https://docs.leankeep.com/guides/authentication): JWT Bearer via AuthCenter; tabela de ambientes (prod/sandbox); resposta do login com o JWT aninhado em `authToken.token` (+ `refreshToken`, `expiresIn` ~2h, `refreshExpiresIn` ~7d); endpoint de refresh (`POST /v1/auth/refresh`, `application/x-www-form-urlencoded` — diferente do login, que é `multipart/form-data`); fluxo de validação via JWKS; endpoints públicos; erros 401/403. - [Boas práticas de segurança para integração com IA](https://docs.leankeep.com/guides/security-ai-integration): Usuário dedicado (Chamado/Operacional, nunca Administrador), menor privilégio, alerta de prompt injection (texto de terceiros retornado pela API não é instrução), confirmação humana antes de operações destrutivas, rotação/revogação de credenciais. - [Conceitos de domínio](https://docs.leankeep.com/guides/concepts): Hierarquia de ativos, modelo de acesso por tipo de usuário, entidades centrais (Plano, Atividade, Aplicação, Tarefa, Ocorrência, Correção). - [Glossário de IDs e enums](https://docs.leankeep.com/guides/glossario-ids-enums): Referência de campos de código usados nos commands — enums com valores fixos no spec (EPlataforma, EStatusAtividade, EStatusAprovacao, EConformidade, EAvaliacoes) e campos dinâmicos por empresa (tipoAnomalia, prioridadeAnomaliaId, tipoCorrecaoId, justificativaNaoRealizado) com endpoints de consulta para cada um. - [Fluxo de ocorrências](https://docs.leankeep.com/guides/flow-ocorrencias): Ciclo de vida de uma ocorrência corretiva — configuração, criação, acompanhamento, correções, aprovação/autorização e SLA automático. - [Fluxo de atividades](https://docs.leankeep.com/guides/flow-atividades): Manutenção preventiva — consulta de agendamentos, baixa de tarefas (individual e em lote), medições, fotos e custos de materiais. - [Relatórios de produtividade](https://docs.leankeep.com/guides/recipe-produtividade): Receita completa para relatórios mensais de atividades e ocorrências por usuário/executor — parâmetros reais, filtros geográficos e combinação dos 4 endpoints de Reports. - [Resolver uma ocorrência (ponta a ponta)](https://docs.leankeep.com/guides/recipe-resolver-ocorrencia): Fluxo completo de manutenção corretiva via v3 — criação de ocorrência (SaveOcorrenciaCommand), registro de ação corretiva (SaveCorrecaoCommand) e aprovação (AprovarOcorrenciaCommand). - [Dar baixa em atividades em lote](https://docs.leankeep.com/guides/recipe-baixa-lote): Marcar múltiplas tarefas preventivas como realizadas em uma única chamada (BaixaAtividadeCommand), com medições (SaveMedicoesAtividadeCommand) e fotos opcionais. - [Relatório de produtividade da equipe](https://docs.leankeep.com/guides/recipe-relatorio-equipe): Agregar produção de toda a equipe por mês e detalhar por técnico (ExecutorId/EmitenteId) usando os 4 endpoints de Reports; EmpresaId vai no header. - [Endpoints utilitários](https://docs.leankeep.com/guides/mobile-sync): Geolocalização do executor (POST /v1/geolocalizacao com latitude, longitude, percentualBateria, tipo; GET /v1/geolocalizacao/status) e leitura de QR Code de áreas/equipamentos (GET /v1/qrcode?QrCode=…, autenticado; GET /v1/qrcode/public?QrCode=…, público). - [Versionamento](https://docs.leankeep.com/guides/versioning): Política de versões — como convivem v1/v2/v3 e quando usar cada uma. - [Tratamento de erros](https://docs.leankeep.com/guides/errors): Códigos HTTP, envelope de erro padrão e como reagir a cada situação. - [Rate limiting](https://docs.leankeep.com/guides/rate-limiting): Limites de requisição, comportamento em 429 e recomendação de backoff. - [Paginação e filtros](https://docs.leankeep.com/guides/pagination-filters): PageIndex/PageSize via query string (não há schema de paginação nomeado na spec), como descobrir o total antes de paginar e como parar o loop sem depender só da API. ## Referência de API - [Introdução](https://docs.leankeep.com/reference/lighthouse-api): Página-índice da referência gerada automaticamente a partir do spec OpenAPI — autenticação, schemas e lista de grupos de endpoints. ## Spec OpenAPI - [OpenAPI 3.0 JSON](https://docs.leankeep.com/openapi/lighthouse.json): Spec completa para importação em Postman, Insomnia, geração de clientes SDK e análise por LLMs. ~1.3MB — acima do limite de 1MB do GPT Actions, use os packs reduzidos abaixo para essa ferramenta. ## Specs reduzidos para GPT Actions Cada um cobre só os endpoints de um caso de uso, bem abaixo de 1MB. Ver [Perguntas de negócio](https://docs.leankeep.com/guides/perguntas-de-negocio) para o fluxo de uso. - [Reports (GPT pack)](https://docs.leankeep.com/openapi/gpt/reports.json): Buscar usuário por nome (`GET /v1/usuarios`) e os 4 endpoints de relatório de produtividade (`summary/occurrences`, `summary/activities`, `useractivitysummary`, `useractivitysummary/occurrences`). - [Ocorrências (GPT pack)](https://docs.leankeep.com/openapi/gpt/ocorrencias.json): Buscar usuário por nome, listar/contar ocorrências v3, consultar configuração e tipos, criar ocorrência e correção. - [Atividades (GPT pack)](https://docs.leankeep.com/openapi/gpt/atividades.json): Buscar usuário por nome, listar atividades, baixa em lote (v2) e justificativas.