Echolot가져오기
cURL, Postman, Insomnia, OpenAPI, Swagger, HAR, Paw, Bruno의 요청을 작업 공간으로 가져오고 가져오기 보고서를 읽는 방법입니다.
Echolot은 다른 도구에서 이미 가지고 있는 요청, 폴더, 인증, 변수, 환경, 스크립트를 작업 공간으로 가져옵니다. 내용을 보고 형식을 판단하고, 자격 증명을 키체인으로 옮기며, 가져오지 못한 항목은 보고서로 알려 줍니다.
Echolot이 가져오는 항목
| 형식 | 파일 | 가져오는 내용 |
|---|---|---|
| cURL | 붙여넣거나 텍스트 파일에 든 curl … 명령 | 요청 하나: 메서드, 주소, 헤더, 본문, Basic 인증, 리디렉션과 TLS 검사 같은 설정. |
| Postman | 컬렉션 v2.0과 v2.1, 환경(.json) | 폴더, 요청, 인증, 컬렉션 변수, 사전 요청 및 테스트 스크립트. 환경은 환경이 됩니다. |
| Insomnia | v4 JSON 내보내기, v5 YAML 컬렉션 | 폴더, 요청, 인증, 환경. |
| OpenAPI | OpenAPI 3.0과 3.1, Swagger 2.0, JSON 또는 YAML | 작업마다 요청 하나. 매개변수, 예시 본문, 보안 스킴의 인증이 포함됩니다. 서버 주소는 {{baseUrl}} 변수가 됩니다. |
| HAR | 브라우저나 프록시의 HTTP Archive 1.2(.har) | 세션의 API 호출. 호스트가 여럿이면 호스트마다 폴더 하나. |
| Paw | Paw와 RapidAPI for Mac 문서(.paw) | 그룹, 요청, 환경. Paw의 동적 값은 가능한 경우 Echolot의 변수와 동적 값이 됩니다. |
| Bruno | 컬렉션 폴더(bruno.json 또는 .bru 파일 포함) | 폴더, 요청, 인증, 환경, 작성된 그대로의 스크립트와 테스트. |
컬렉션, 명세, HAR 파일, Bruno 폴더는 이름을 따서 만든 별도 폴더에 들어갑니다. cURL 명령은 요청 하나가 됩니다.
Claude Desktop, Claude Code, Cursor, VS Code, Codex의 MCP 서버 설정도 MCP 서버로 가져올 수 있습니다. 서버 추가를 참고하십시오.
앱에서 가져오기
다음 방법 중 하나를 쓰면 됩니다. 가져온 항목은 사이드바에서 선택한 폴더, 또는 작업 공간 맨 위에 들어갑니다.
- 파일 › 가져오기…(⇧⌘I), 또는 사이드바의 + 메뉴나 명령 팔레트의 가져오기…. 파일을 하나 또는 여러 개, 또는 Bruno 컬렉션 폴더를 선택합니다.
- 파일이나 Bruno 폴더를 윈도우 콘텐츠 패널의 아무 곳이나 사이드바의 폴더에 드롭합니다.
- cURL 명령이나 컬렉션 또는 명세의 텍스트를 사이드바에 붙여넣기합니다(사이드바에 초점이 있을 때 ⌘V).
- cURL 명령을 요청의 주소 필드에 붙여넣기. 이 방법은 요청을 새로 만들지 않습니다. 열려 있는 요청의 메서드, 주소, 헤더, 본문, 인증, 설정을 바꾸고 이름과 위치는 그대로 둡니다. 사용하지 못한 항목은 주소 막대 아래에 cURL 참고 사항으로 표시됩니다.
가져오기 보고서
가져온 뒤에는 보고서가 열립니다. 제목에는 무엇을 가져왔는지("요청 22개, 폴더 7개를 가져옴")가 나오고, 그 아래에 어떤 형식에서 왔는지와 모두 가져왔는지가 나옵니다. 그다음 파일마다 다음이 나옵니다.
- 그대로 가져올 수 없었던 모든 항목에 대한 메모. 메모 없이 버려지는 것은 없습니다.
- 비밀 값: 파일 대신 키체인에 저장된 값의 이름. 값 자체는 나오지 않습니다.
사이드바에서 보기는 가져온 항목을 선택하고, 완료는 보고서를 닫습니다. 메모할 것이 없는 cURL 명령 하나는 보고서 없이 바로 열립니다.
비밀 값은 키체인으로
작업 공간 파일에는 암호, 토큰, 키가 평문으로 들어가지 않으므로 Git에 커밋해도 됩니다.
- 요청에 입력한 자격 증명(인증,
Authorization헤더, API 키 헤더)은 요청과 필드의 이름을 딴 비밀 변수가 됩니다. 예를 들어curl -u heidi:alpenglow https://demo.echolot.dev/echo/basic-auth/heidi/alpenglow는heidi-alpenglow라는 요청을 만들고 그 암호는{{heidi_alpenglow_password}}가 되며, 값은 키체인으로 갑니다. - 환경과 컬렉션의 비밀 값도 같은 방식으로 키체인으로 갑니다.
주소의 쿼리 문자열, 본문, user:password@ 형식 주소 안의 자격 증명은 아직 옮기지 않습니다. 가져온 작업 공간을 커밋하기 전에 확인하십시오.
비밀 값을 참고하십시오.
스크립트
Postman의 사전 요청 및 테스트 스크립트는 그대로 가져오며 Echolot의 pm.* 샌드박스에서 실행됩니다. 앱은 가져온 스크립트를 사용자가 신뢰한 뒤에만 실행합니다.
보고서에 스크립트가 몇 개였는지 나오고, 스크립트가 필요한 첫 전송에서 검토하라고 묻습니다(스크립트 검토…). Bruno의 스크립트와 테스트는 작성된 그대로
가져오지만, Bruno의 bru, req, res는 Postman의 pm이 아니므로 실행하기 전에 수정이 필요할 수 있습니다.
스크립트와 테스트를 참고하십시오.
가져오지 못하는 항목
보고서는 다음 항목이 발생할 때마다 알려 줍니다.
| 형식 | 제외되거나 변경되는 항목 |
|---|---|
| cURL | 쿠키 파일, Echolot에 설정이 없는 옵션, 콜론이 없는 헤더. 파일에서 읽는 본문이나 양식 필드(-d @file, -F field=@file)는 요청을 보낼 때 그 파일에서 읽습니다. |
| Postman | Echolot에 없는 인증 유형. 파일 본문과 파일 필드: 파일을 다시 선택하십시오. |
| Insomnia | Echolot에 없는 종류의 항목. Echolot에 대응하는 것이 없는 템플릿 태그({% … %})는 텍스트로 남습니다. Echolot에 없는 인증 유형. 파일 본문과 필드. Echolot이 제공하지 않는 OAuth 2.0 그랜트는 인증 코드 그랜트가 됩니다. |
| OpenAPI | 요청에 담을 수 없는 위치의 매개변수, 담을 수 없는 유형의 요청 본문, OAuth 플로(인증을 직접 설정하십시오), 쿠키로 보내는 API 키(Cookie 헤더를 추가하십시오). 서버가 없거나 서버 주소가 상대 주소인 명세: 보내기 전에 {{baseUrl}}을 설정하십시오. 사용 중단된 작업도 그대로 가져옵니다. |
| HAR | 이미지, 글꼴, 스크립트, 스타일시트. 반복된 요청은 한 번만 가져옵니다. 브라우저의 세션 자격 증명을 담은 헤더: 대신 폴더에 인증을 설정하십시오. |
| Paw | Echolot에 없는 유형의 동적 값은 빈 텍스트가 됩니다. 파일 참조와 클라이언트 인증서: 다시 설정하십시오. |
| Bruno | Echolot에 없는 본문 및 인증 모드. 폴더 전체가 공유하는 헤더(Echolot 폴더에는 없음): 요청이나 사전 요청 스크립트에 추가하십시오. Echolot에 대응하는 것이 없는 연산자를 쓰는 검사. |
OpenAPI 파일은 연결된 채로 유지
OpenAPI나 Swagger 파일을 가져오면 사본도 작업 공간의 specs/ 폴더에 보관되고, 새 요청 폴더는 그 명세를 따릅니다. 명세가 바뀌면 Echolot이 무엇이 바뀌었는지
보여 주고 요청에 적용할 수 있습니다. 명세는 명세 페이지에서 편집합니다.
명령줄에서 가져오기
echolot import는 같은 형식을 작업 공간 폴더로 가져오므로, 마이그레이션을 스크립트로 만들거나 CI에서 가져올 수 있습니다.
echolot import Alpenglow.postman_collection.json -w "Alpenglow.echolot"
echolot import staging.postman_environment.json -w "Alpenglow.echolot"
echolot import openapi.yaml -w "Alpenglow.echolot" --folder catalog
pbpaste | echolot import - -w "Alpenglow.echolot" # a cURL command from the clipboard내용에서 형식을 감지하며, --format을 쓰면 감지를 건너뜁니다(curl, postman-collection, postman-environment, openapi, swagger, insomnia,
har, paw 또는 mcp-config). 같은 보고서를 출력합니다.
Imported 22 requests, 7 folders from Postman collection v2.1.
warning: 19 pre-request or test scripts were imported; Echolot runs them once you trust them.Mac에서는 앱에서와 같이 비밀 값이 키체인으로 갑니다. 키체인이 없는 곳(Linux 또는 ECHOLOT_KEYCHAIN=0)에서는 파일에 들어가지 않으며, 도구가 보내는 곳에서
어떤 ECHOLOT_SECRET_<NAME> 변수를 설정해야 하는지 알려 줍니다. 명령줄 도구 자체는 Newman처럼 모든 스크립트를 묻지 않고 실행합니다.
Postman 컬렉션을 실행하려고 가져올 필요는 없습니다. echolot run collection.json은 컬렉션을 그대로 실행합니다. 가져오기 및 내보내기와
echolot run을 참고하십시오.
반대 방향은 내보내기를 참고하십시오.