Cos'è Decoy?

Decoy è una potente e intuitiva applicazione nativa per macOS, progettata per gli sviluppatori che necessitano di creare e gestire facilmente server mock locali. Semplifica il processo di simulazione di endpoint API, test di integrazioni webhook e debug di codice dipendente dalla rete, fornendo un ambiente diretto e senza necessità di configurazione. A differenza dei metodi tradizionali che spesso comportano configurazioni complesse, container Docker o servizi di tunneling basati su cloud, Decoy offre un'esperienza immediata direttamente sul tuo Mac.

Costruito con tecnologie macOS moderne come SwiftUI e Network.framework, Decoy è ottimizzato per prestazioni ed efficienza delle risorse. Si avvia istantaneamente, consuma poca memoria e consente modifiche in tempo reale alle risposte mock, garantendo un flusso di lavoro di sviluppo senza interruzioni. Sia che tu stia costruendo una nuova applicazione, integrando con servizi di terze parti o testando casi limite come guasti di rete e timeout, Decoy fornisce la flessibilità e il controllo necessari per accelerare il tuo ciclo di sviluppo.

Creazione Server Mock Semplificata

• Creazione Server Mock Senza Sforzo: Definisci endpoint con metodi personalizzati, percorsi e raggruppali in progetti per una migliore organizzazione.
• Monitoraggio Richieste in Tempo Reale: Visualizza tutte le richieste in arrivo con informazioni dettagliate, inclusi header, corpo, IP sorgente e timestamp. I payload JSON vengono formattati automaticamente per una migliore leggibilità.
• Mocking Flessibile delle Risposte: Configura risposte con qualsiasi codice di stato HTTP, scegli tra 7 diversi tipi di corpo (testo semplice, JSON, HTML, XML, file, vuoto, redirect), simula latenza e imposta header personalizzati.
• Percorsi Parametrizzati: Supporto per percorsi dinamici come /users/:id per corrispondere a vari parametri di richiesta.
• Molteplici Tipi di Corpo Risposta: Servi facilmente JSON, HTML, XML, testo semplice, file (immagini, PDF), risposte vuote o esegui reindirizzamenti.
• Modifiche Istantanee: Le modifiche agli endpoint o alle risposte hanno effetto immediato alla richiesta in arrivo successiva.
• Esportazione Richieste: Copia i dettagli della richiesta come snippet di codice cURL, JavaScript fetch o Ruby per un facile debug e condivisione.
• Gestione Automatica CORS: Gli header CORS vengono aggiunti automaticamente, garantendo che le richieste basate su browser funzionino senza problemi.
• Risposte File: Servi file statici direttamente come risposte.
• Esperienza Nativa macOS: Costruito con SwiftUI per un'applicazione veloce, reattiva ed efficiente in termini di memoria. Non sono richiesti Docker, tunnel cloud o file di configurazione complessi.
• Raggruppamento Progetti: Organizza gli endpoint sotto sottodomini personalizzati (es. api.decoy.my).
• Snapshot Risposte: Rivedi le risposte esatte che sono state inviate per ogni richiesta.
• Domini Personalizzati: Utilizza domini predefiniti come decoy.my o lvh.me, oppure configura i tuoi.
• Ispezione Dettagliata Richieste: Esamina header, corpo (con dump esadecimale per dati binari), IP sorgente, timestamp e un UUID univoco per ogni richiesta.
• Supporto Redirect: Configura facilmente reindirizzamenti 301, 302, 307 e 308 con gestione automatica dell'header Location.
• Archiviazione Persistente: Le richieste vengono salvate in un database SQLite, garantendo che non ci siano perdite di dati anche se l'app si chiude inaspettatamente.

Come Usare Decoy

Iniziare con Decoy è stato progettato per essere semplice:

1. Installa Decoy: Scarica e installa Decoy dal Mac App Store.
2. Crea un Progetto: Avvia Decoy e crea un nuovo progetto. Puoi assegnare un sottodominio personalizzato (es. myapi) o utilizzare il dominio predefinito decoy.my.
3. Definisci Endpoint: Aggiungi nuovi endpoint all'interno del tuo progetto. Specifica il metodo HTTP (GET, POST, PUT, DELETE, ecc.) e il percorso (es. /users, /products/:id).
4. Configura Risposte: Per ogni endpoint, definisci la risposta desiderata. Scegli il codice di stato, seleziona il tipo di corpo (JSON, testo, file, ecc.), aggiungi eventuali header necessari e imposta opzionalmente un ritardo per simulare la latenza di rete.
5. Indirizza la Tua Applicazione: Configura la tua applicazione, script o servizio per inviare richieste all'indirizzo fornito da Decoy (es. http://myapi.decoy.my:8998).
6. Monitora e Debugga: Man mano che le richieste arrivano, Decoy le visualizzerà in tempo reale. Puoi ispezionare tutti i dettagli della richiesta in arrivo e verificare la risposta inviata.
7. Itera: Apporta modifiche alle configurazioni dei tuoi endpoint o alle risposte al volo. Decoy applica queste modifiche istantaneamente, consentendo un'iterazione e un debug rapidi.

Casi d'Uso

• Sviluppo e Test API: Simula risposte API backend durante lo sviluppo frontend, permettendo ai team di lavorare in parallelo senza attendere il completamento del backend. Testa vari scenari di risposta, inclusi codici di errore e casi limite.
• Test Integrazione Webhook: Testa facilmente come la tua applicazione gestisce i webhook in arrivo da servizi di terze parti come Stripe, GitHub o Slack impostando Decoy per ricevere e ispezionare questi payload localmente.
• Sviluppo App Mobile: Simula richieste di rete per applicazioni mobili per testare il comportamento dell'interfaccia utente, scenari offline e gestione degli errori senza fare affidamento su un backend live.
• Test Resilienza di Rete: Simula condizioni di rete lente o timeout introducendo ritardi nelle risposte di Decoy, aiutando a costruire applicazioni più robuste che gestiscono la latenza con grazia.
• Sviluppo Scraper e Bot: Testa scraper o bot che interagiscono con servizi web fornendo risposte prevedibili da un server mock locale.

FAQ

• **Quali sono i requisiti di sistema per Decoy? Decoy richiede macOS 14 Sonoma o versioni successive.

• **Decoy è gratuito? Decoy è un'applicazione a pagamento disponibile per l'acquisto sul Mac App Store a €24.99.

• **Ho bisogno di Docker o Node.js per usare Decoy? No, Decoy è un'applicazione nativa macOS autonoma. Non richiede Docker, Node.js o altri ambienti di runtime esterni per la sua funzionalità principale.

• **Decoy può gestire richieste HTTPS? Attualmente, Decoy si concentra sulle richieste HTTP. Per il mocking HTTPS, in genere è necessario configurare un proxy inverso o utilizzare un diverso set di strumenti.

• **Come vengono archiviate le richieste? Le richieste in arrivo vengono salvate in un database SQLite locale, garantendo che la cronologia delle richieste venga preservata anche se l'applicazione viene chiusa inaspettatamente.