APIs
O projeto APIs é uma suite de serviços RESTful projetada para desenvolvedores que precisam de capacidades de web scraping, data extraction e integração de dados em suas aplicações. A motivação principal foi criar uma camada de abstração robusta sobre tarefas complexas de coleta e transformação de dados, oferecendo endpoints simples e bem documentados que qualquer desenvolvedor pode integrar em minutos.
A suite inclui múltiplos endpoints especializados. O módulo de article scraping extrai conteúdo estruturado de páginas web — título, corpo do texto, autor, data de publicação e imagens — retornando tudo em JSON limpo. O módulo de data extraction processa documentos e páginas para identificar e estruturar informações como tabelas, listas e metadados. Há também endpoints para consultas agregadas, transformação de formatos e enriquecimento de dados com fontes externas.
A arquitetura é construída sobre FastAPI, escolhido por sua performance assíncrona nativa, validação automática via Pydantic e geração automática de documentação OpenAPI/Swagger. O PostgreSQL serve como banco de dados principal, armazenando resultados de consultas, cache de extrações e metadados de uso. O sistema implementa rate limiting por API key, cache inteligente para evitar reprocessamento e logging detalhado para auditoria. Toda a stack roda em containers Docker com Docker Compose, permitindo deploy em qualquer provedor de nuvem.
Um diferencial importante é a documentação interativa: cada endpoint possui exemplos de requisição e resposta, códigos de erro documentados e a possibilidade de testar diretamente no navegador via Swagger UI. A autenticação é feita por API keys com diferentes níveis de permissão, permitindo controlar acesso a endpoints premium. O projeto foi pensado para ser modular — novos endpoints podem ser adicionados sem impactar os existentes, seguindo o princípio de responsabilidade única.