O que é Decoy?

Decoy é uma aplicação nativa poderosa e intuitiva para macOS, projetada para desenvolvedores que precisam criar e gerenciar mock servers locais com facilidade. Simplifica o processo de simular endpoints de API, testar integrações de webhook e depurar código dependente de rede, fornecendo um ambiente direto e sem necessidade de configuração. Diferente de métodos tradicionais que frequentemente envolvem configurações complexas, contêineres Docker ou serviços de tunneling baseados em nuvem, Decoy oferece uma experiência imediata diretamente no seu Mac.

Construído com tecnologias modernas do macOS como SwiftUI e Network.framework, Decoy é otimizado para desempenho e eficiência de recursos. Ele inicia instantaneamente, consome memória mínima e permite alterações em tempo real nas respostas simuladas, garantindo um fluxo de trabalho de desenvolvimento contínuo. Seja construindo uma nova aplicação, integrando com serviços de terceiros ou testando casos extremos como falhas de rede e timeouts, Decoy fornece a flexibilidade e o controle necessários para acelerar seu ciclo de desenvolvimento.

Funcionalidades Principais

• Criação de Mock Server Sem Esforço: Defina endpoints com métodos e caminhos personalizados, e agrupe-os em projetos para melhor organização.
• Monitoramento de Requisições em Tempo Real: Visualize todas as requisições recebidas com informações detalhadas, incluindo headers, corpo, IP de origem e timestamps. Payloads JSON são formatados automaticamente para legibilidade.
• Simulação Flexível de Respostas: Configure respostas com qualquer código de status HTTP, escolha entre 7 tipos de corpo diferentes (texto puro, JSON, HTML, XML, arquivo, vazio, redirect), defina latência e headers personalizados.
• Caminhos Parametrizados: Suporte para caminhos dinâmicos como /users/:id para corresponder a vários parâmetros de requisição.
• Múltiplos Tipos de Corpo de Resposta: Sirva facilmente JSON, HTML, XML, texto puro, arquivos (imagens, PDFs), respostas vazias ou execute redirects.
• Mudanças Instantâneas: Modificações em endpoints ou respostas entram em vigor imediatamente na próxima requisição recebida.
• Exportação de Requisição: Copie detalhes da requisição como snippets de código cURL, JavaScript fetch ou Ruby para fácil depuração e compartilhamento.
• Tratamento Automático de CORS: Headers CORS são adicionados automaticamente, garantindo que requisições baseadas no navegador funcionem perfeitamente.
• Respostas de Arquivo: Sirva arquivos estáticos diretamente como respostas.
• Experiência Nativa do macOS: Construído com SwiftUI para uma aplicação rápida, responsiva e eficiente em memória. Sem Docker, túneis na nuvem ou arquivos de configuração complexos necessários.
• Agrupamento de Projetos: Organize endpoints sob subdomínios personalizados (ex: api.decoy.my).
• Snapshots de Resposta: Revise as respostas exatas que foram enviadas para cada requisição.
• Domínios Personalizados: Use domínios padrão como decoy.my ou lvh.me, ou configure os seus.
• Inspeção Detalhada de Requisição: Examine headers, corpo (com dump hexadecimal para dados binários), IP de origem, timestamps e um UUID único para cada requisição.
• Suporte a Redirect: Configure facilmente redirects 301, 302, 307 e 308 com tratamento automático de header Location.
• Armazenamento Persistente: Requisições são salvas em um banco de dados SQLite, garantindo que não haja perda de dados mesmo se o app fechar inesperadamente.

Como Usar Decoy

Começar com Decoy foi projetado para ser simples:

1. Instale o Decoy: Baixe e instale o Decoy da Mac App Store.
2. Crie um Projeto: Inicie o Decoy e crie um novo projeto. Você pode atribuir um subdomínio personalizado (ex: myapi) ou usar o domínio padrão decoy.my.
3. Defina Endpoints: Adicione novos endpoints dentro do seu projeto. Especifique o método HTTP (GET, POST, PUT, DELETE, etc.) e o caminho (ex: /users, /products/:id).
4. Configure Respostas: Para cada endpoint, defina a resposta desejada. Escolha o código de status, selecione o tipo de corpo (JSON, texto, arquivo, etc.), adicione quaisquer headers necessários e, opcionalmente, defina um atraso para simular latência de rede.
5. Aponte Sua Aplicação: Configure sua aplicação, script ou serviço para enviar requisições para o endereço fornecido pelo Decoy (ex: http://myapi.decoy.my:8998).
6. Monitore e Depure: À medida que as requisições chegam, o Decoy as exibirá em tempo real. Você pode inspecionar todos os detalhes da requisição recebida e verificar a resposta enviada.
7. Itere: Faça alterações nas configurações de endpoints ou respostas de forma dinâmica. O Decoy aplica essas mudanças instantaneamente, permitindo iteração e depuração rápidas.

Casos de Uso

• Desenvolvimento e Teste de API: Simule respostas de API backend durante o desenvolvimento frontend, permitindo que as equipes trabalhem em paralelo sem esperar pela conclusão do backend. Teste vários cenários de resposta, incluindo códigos de erro e casos extremos.
• Teste de Integração de Webhook: Teste facilmente como sua aplicação lida com webhooks recebidos de serviços de terceiros como Stripe, GitHub ou Slack, configurando o Decoy para receber e inspecionar esses payloads localmente.
• Desenvolvimento de Aplicativos Móveis: Simule requisições de rede para aplicativos móveis para testar o comportamento da UI, cenários offline e tratamento de erros sem depender de um backend ativo.
• Teste de Resiliência de Rede: Simule condições de rede lentas ou timeouts introduzindo atrasos nas respostas do Decoy, ajudando a construir aplicações mais robustas que lidam com latência graciosamente.
• Desenvolvimento de Scraper e Bot: Teste scrapers ou bots que interagem com serviços web, fornecendo respostas previsíveis de um mock server local.

FAQ

• **Quais são os requisitos de sistema para o Decoy? Decoy requer macOS 14 Sonoma ou posterior.

• **O Decoy é gratuito? Decoy é uma aplicação paga disponível para compra na Mac App Store por €24.99.

• **Preciso de Docker ou Node.js para usar o Decoy? Não, Decoy é uma aplicação nativa autocontida para macOS. Não requer Docker, Node.js ou qualquer outro ambiente de execução externo para sua funcionalidade principal.

• **O Decoy pode lidar com requisições HTTPS? Atualmente, o Decoy foca em requisições HTTP. Para simulação HTTPS, você normalmente precisaria configurar um proxy reverso ou usar um conjunto diferente de ferramentas.

• **Como as requisições são armazenadas? Requisições recebidas são salvas em um banco de dados SQLite local, garantindo que seu histórico de requisições seja preservado mesmo se a aplicação for fechada inesperadamente.