Insomnia

누가 사용하는 프로그램인가

백엔드 개발자, API를 연결하는 프런트엔드 개발자, 응답과 오류를 재현하는 QA 담당자에게 맞는 도구다. 브라우저 화면을 거치지 않고 API에 직접 요청을 보내므로 서버의 응답과 화면 구현 문제를 나누어 살펴보기 좋다.

단일 호출을 확인하는 데서 시작해 관련 요청을 폴더로 정리하고 명세와 테스트를 같은 API Collection에서 관리할 수 있다. 아래 내용은 공식 자료를 확인해 작성했으며 설치·사용 체험을 전제로 하지 않는다.

지원 OS와 버전 검토

등록 정보에는 macOS만 표시되어 있지만 공식 문서는 macOS·Windows·Ubuntu 설치를 안내한다. macOS용은 공식 다운로드 페이지에서 배포 경로를 확인하면 된다.

2026년 10월 9일 확인한 공식 GitHub 배포 페이지는 13.3.0을 Latest로 표시한다. 이 버전부터 기존 문서와 컬렉션은 API Collection으로 통합되며 OpenAPI 명세는 Spec 탭에서 다룬다. 공식 배포와 문서가 계속 갱신되고 있어 지원 종료 제품으로 볼 근거는 확인되지 않았다.

설치와 첫 요청 순서

공식 다운로드 페이지에서 macOS용 배포 파일을 선택해 설치한다. 로그인 없이 시작하려면 로그인 화면 하단의 Use the local Scratch Pad를 선택한다. 이후 API Collection을 만들고 + 버튼에서 HTTP 요청을 추가한다.

먼저 테스트 서버의 조회 URL과 GET 메서드를 입력한다. Params에서 쿼리 값을, Headers에서 필요한 헤더를, Auth에서 인증 방식을 설정한 뒤 Send로 응답을 확인한다. POST 요청은 Body 형식과 서버가 요구하는 Content-Type도 맞춘다. 처음부터 운영 데이터를 변경하는 요청보다 조회 요청으로 연결과 인증을 점검하는 편이 좋다.

환경 변수와 실무 테스트 예시

예를 들어 주문 API를 검증한다면 서버 주소를 base_url, 테스트용 토큰을 token 변수로 두고 개발·스테이징 하위 환경을 만든다. 같은 요청을 복제하지 않고 환경 선택만 바꿔 서버별 결과를 비교할 수 있다.

로그인, 주문 생성, 주문 조회 요청을 준비하고 응답 후 스크립트로 토큰과 주문 ID를 저장하면 다음 요청에서 재사용할 수 있다. Collection Runner로 이 순서를 실행하면서 상태 코드와 응답 필드를 검증하는 방식이다. 실제 적용 전에는 테스트 계정과 테스트 데이터를 준비한다.

공유하지 않을 값은 비공개 하위 환경에 분리할 수 있다. 공식 문서에 따르면 비공개 하위 환경은 동기화·내보내기 대상에서 제외되며 접근에 vault key가 필요하다.

무료판과 유료 기능의 경계

Scratch Pad는 로그인 없이 쓰는 무료 로컬 작업 공간이다. 무료 Essentials는 로컬·클라우드 프로젝트, 환경, 컬렉션 실행을 무제한으로 제공하며 mock 서버 요청은 월 1,000회 포함한다.

Git Sync를 활성화한 Essentials 조직은 최대 3명으로 제한된다. Git Sync를 끄면 사용자 수 제한 없이 구성할 수 있다. Pro는 Git Sync 사용자 제한 해제와 조직 역할 기반 접근 제어를 제공하고, Enterprise는 SSO·SCIM과 저장 위치 정책 등을 추가한다. 따라서 개인의 API 호출 확인과 조직의 계정·보안 관리 요구를 구분해 요금제를 검토해야 한다.

요청이 실패할 때 확인 순서

잘못된 응답이 나오면 메서드와 최종 URL, 선택한 환경, 쿼리 값, 본문 형식, 인증 헤더 순으로 확인한다. 같은 변수 이름을 여러 수준에 정의했다면 폴더 환경이 컬렉션·전역 환경보다 우선하므로 값이 덮어써졌는지도 살핀다. 인증 오류는 토큰 유효기간과 폴더 인증 상속 설정부터 점검한다.

연결 자체가 실패하면 서버 접근 가능 여부와 회사 프록시를 확인한다. Insomnia는 OS 프록시를 자동 감지하며 Preferences > Proxy에서 수정할 수 있다. 로그인·업데이트·동기화만 실패할 때는 해당 공식 서비스 도메인의 네트워크 허용 여부를 확인한다. Git Sync는 저장소의 비밀정보 노출을 자동으로 막아주지 않으므로 공유 전에 토큰 포함 여부를 검토한다.

다른 도구와 선택 기준

도구를 고를 때는 팀이 가진 요청 자산과 저장·검토 방식부터 확인한다. 기존 Postman 컬렉션이나 cURL 명령을 옮겨 검토하려면 Insomnia의 가져오기 기능을 활용할 수 있지만, 이전 후 인증·변수·스크립트 동작은 다시 확인해야 한다.

여러 프로토콜을 GUI에서 다루고 OpenAPI 명세와 요청을 함께 관리하려는 경우 Insomnia를 후보로 삼을 수 있다. 짧은 명령 실행이 중심인지, 팀이 Git 변경 이력을 검토하는지, 클라우드 동기화가 필요한지를 기준으로 다른 API 도구와 비교하면 된다. 자동화가 필요하다면 Inso CLI로 컬렉션을 실행하는 경로도 검토할 수 있다.

공식 안내

• The Collaborative API Development Platform - Insomnia · 확인 2026-10-09
• Download - Insomnia · 확인 2026-10-09
• Insomnia | Kong Docs · 확인 2026-10-09
• Release 13.3.0 · Kong/insomnia · 확인 2026-10-09
• API Collections in Insomnia | Kong Docs · 확인 2026-10-09
• Requests in Insomnia · 확인 2026-10-09
• Environments · 확인 2026-10-09
• Storage options in Insomnia · 확인 2026-10-09
• Pricing - Insomnia · 확인 2026-10-09
• Insomnia proxy and allowlist · 확인 2026-10-09