Decoy란 무엇인가요?

Decoy는 개발자가 로컬 모의 서버를 손쉽게 생성하고 관리할 수 있도록 설계된 강력하고 직관적인 네이티브 macOS 애플리케이션입니다. 복잡한 설정이 필요 없는 환경을 제공하여 API 엔드포인트 시뮬레이션, 웹훅 통합 테스트, 네트워크 관련 코드 디버깅 과정을 간소화합니다. 복잡한 구성, Docker 컨테이너 또는 클라우드 기반 터널링 서비스를 포함하는 기존 방식과 달리, Decoy는 Mac에서 즉시 사용 가능한 경험을 제공합니다.

SwiftUI 및 Network.framework와 같은 최신 macOS 기술로 구축된 Decoy는 성능과 리소스 효율성을 위해 최적화되었습니다. 즉시 실행되고 최소한의 메모리를 소비하며 모의 응답에 대한 실시간 변경을 허용하여 원활한 개발 워크플로우를 보장합니다. 새 애플리케이션을 구축하거나, 타사 서비스와 통합하거나, 네트워크 장애 및 시간 초과와 같은 엣지 케이스를 테스트하는 경우, Decoy는 개발 주기 가속화에 필요한 유연성과 제어 기능을 제공합니다.

주요 기능

손쉬운 모의 서버 생성: 사용자 지정 메서드, 경로를 사용하여 엔드포인트를 정의하고 프로젝트별로 그룹화하여 구성을 용이하게 합니다.
실시간 요청 모니터링: 헤더, 본문, 소스 IP 및 타임스탬프를 포함한 상세 정보로 모든 들어오는 요청을 확인합니다. JSON 페이로드는 가독성을 위해 자동으로 서식이 지정됩니다.
유연한 응답 모의: 모든 HTTP 상태 코드로 응답을 구성하고, 7가지 다른 본문 유형(일반 텍스트, JSON, HTML, XML, 파일, 비어 있음, 리디렉션) 중에서 선택하고, 사용자 지정 헤더를 설정하고, 지연 시간을 시뮬레이션합니다.
매개변수화된 경로: 다양한 요청 매개변수와 일치시키기 위해 /users/:id와 같은 동적 경로를 지원합니다.
다중 응답 본문 유형: JSON, HTML, XML, 일반 텍스트, 파일(이미지, PDF), 빈 응답을 쉽게 제공하거나 리디렉션을 수행합니다.
즉각적인 변경: 엔드포인트 또는 응답 수정은 다음 들어오는 요청에서 즉시 적용됩니다.
요청 내보내기: 디버깅 및 공유를 위해 cURL, JavaScript fetch 또는 Ruby 코드 조각으로 요청 세부 정보를 복사합니다.
자동 CORS 처리: CORS 헤더가 자동으로 추가되어 브라우저 기반 요청이 원활하게 작동합니다.
파일 응답: 정적 파일을 응답으로 직접 제공합니다.
네이티브 macOS 경험: SwiftUI로 구축되어 빠르고 반응성이 뛰어나며 메모리 효율적인 애플리케이션입니다. Docker, 클라우드 터널 또는 복잡한 구성 파일이 필요하지 않습니다.
프로젝트 그룹화: 사용자 지정 하위 도메인(예: api.decoy.my)으로 엔드포인트를 구성합니다.
응답 스냅샷: 각 요청에 대해 전송된 정확한 응답을 검토합니다.
사용자 지정 도메인: decoy.my 또는 lvh.me와 같은 기본 도메인을 사용하거나 사용자 지정 도메인을 구성합니다.
상세 요청 검사: 헤더, 본문(바이너리 데이터의 경우 16진수 덤프 포함), 소스 IP, 타임스탬프 및 각 요청에 대한 고유 UUID를 검사합니다.
리디렉션 지원: 자동 Location 헤더 처리를 통해 301, 302, 307 및 308 리디렉션을 쉽게 구성합니다.
영구 저장: 요청은 SQLite 데이터베이스에 저장되어 앱이 예기치 않게 종료되어도 데이터 손실이 없습니다.

Decoy 사용 방법

Decoy 시작은 간단합니다:

Decoy 설치: Mac App Store에서 Decoy를 다운로드하여 설치합니다.
프로젝트 생성: Decoy를 실행하고 새 프로젝트를 만듭니다. 사용자 지정 하위 도메인(예: myapi)을 할당하거나 기본 decoy.my 도메인을 사용할 수 있습니다.
엔드포인트 정의: 프로젝트 내에서 새 엔드포인트를 추가합니다. HTTP 메서드(GET, POST, PUT, DELETE 등)와 경로(예: /users, /products/:id)를 지정합니다.
응답 구성: 각 엔드포인트에 대해 원하는 응답을 정의합니다. 상태 코드를 선택하고, 본문 유형(JSON, 텍스트, 파일 등)을 선택하고, 필요한 헤더를 추가하고, 선택적으로 지연 시간을 설정하여 네트워크 지연 시간을 시뮬레이션합니다.
애플리케이션 연결: 애플리케이션, 스크립트 또는 서비스를 Decoy에서 제공하는 주소(예: http://myapi.decoy.my:8998)로 요청을 보내도록 구성합니다.
모니터링 및 디버깅: 요청이 들어오면 Decoy는 실시간으로 표시합니다. 들어오는 요청의 모든 세부 정보를 검사하고 전송된 응답을 확인할 수 있습니다.
반복: 엔드포인트 구성 또는 응답을 즉석에서 변경합니다. Decoy는 이러한 변경 사항을 즉시 적용하여 신속한 반복 및 디버깅을 가능하게 합니다.

사용 사례

API 개발 및 테스트: 프런트엔드 개발 중에 백엔드 API 응답을 시뮬레이션하여 백엔드 완료를 기다리지 않고 팀이 병렬로 작업할 수 있도록 합니다. 다양한 응답 시나리오(오류 코드 및 엣지 케이스 포함)를 테스트합니다.
웹훅 통합 테스트: Stripe, GitHub 또는 Slack과 같은 타사 서비스의 들어오는 웹훅을 처리하는 방법을 애플리케이션에서 테스트합니다. Decoy를 설정하여 이러한 페이로드를 로컬에서 수신하고 검사합니다.
모바일 앱 개발: 라이브 백엔드에 의존하지 않고 UI 동작, 오프라인 시나리오 및 오류 처리를 테스트하기 위해 모바일 애플리케이션의 네트워크 요청을 모의합니다.
네트워크 복원력 테스트: Decoy의 응답에 지연 시간을 추가하여 느린 네트워크 조건 또는 시간 초과를 시뮬레이션하여 지연 시간을 우아하게 처리하는 더 강력한 애플리케이션을 구축하는 데 도움을 줍니다.
스크레이퍼 및 봇 개발: 로컬 모의 서버에서 예측 가능한 응답을 제공하여 웹 서비스와 상호 작용하는 스크레이퍼 또는 봇을 테스트합니다.

FAQ

Decoy의 시스템 요구 사항은 무엇인가요? Decoy는 macOS 14 Sonoma 이상이 필요합니다.
Decoy는 무료인가요? Decoy는 Mac App Store에서 24.99유로에 구매할 수 있는 유료 애플리케이션입니다.
Decoy를 사용하려면 Docker 또는 Node.js가 필요한가요? 아니요, Decoy는 독립형 네이티브 macOS 애플리케이션입니다. 핵심 기능을 위해 Docker, Node.js 또는 기타 외부 런타임 환경이 필요하지 않습니다.
Decoy는 HTTPS 요청을 처리할 수 있나요? 현재 Decoy는 HTTP 요청에 중점을 둡니다. HTTPS 모의의 경우 일반적으로 역방향 프록시를 구성하거나 다른 도구 세트를 사용해야 합니다.
요청은 어떻게 저장되나요? 들어오는 요청은 로컬 SQLite 데이터베이스에 저장되어 애플리케이션이 예기치 않게 종료되어도 요청 기록이 보존됩니다.

Decoy