Postman에 외부 라이브러리 추가하는 방법

안녕하세요, API 애호가 여러분! 우리는 모두 Postman이 API 개발 및 테스트 워크플로를 간소화하는 데 혁신적이라는 것을 알고 있습니다. 하지만 Postman 환경에 더 많은 기능을 추가할 수 있다면 어떻게 될까요? 외부 라이브러리의 마법을 소개합니다!

Postman에 외부 라이브러리를 추가하면 가능성의 보물이 열립니다. Moment.js와 같은 강력한 도구를 날짜 조작에 원활하게 통합하거나, 데이터를 변환하는 Lodash, 또는 특정 요구에 맞는 사용자 정의 라이브러리를 상상해 보세요. 이 게시물은 Postman에서 외부 라이브러리의 잠재력을 활용하는 종합 가이드가 되어, 여러분의 API 테스트 경험을 지금까지보다 더 매끄럽고 효율적으로 만들어 줄 것입니다.

Postman에서 외부 라이브러리를 사용하는 이유는?

세부 사항에 들어가기에 앞서, 외부 라이브러리를 활용해야 할 설득력 있는 이유를 살펴보겠습니다:

강화된 기능: 라이브러리는 종종 일반적인 작업을 위한 미리 작성된 코드를 제공하여 귀중한 시간과 노력을 절약해 줍니다. 날짜 포맷이 필요하거나, JSON을 파싱하거나, 문자열 조작을 해야 하나요? 외부 라이브러리가 당신을 지원합니다.
코드 재사용성: 반복적인 코드 조각을 잊어버리세요. 라이브러리를 사용하면 함수를 한 번 정의하고 Postman 컬렉션 전반에 걸쳐 재사용할 수 있어, 더 깨끗하고 유지보수가 용이한 코드를 촉진합니다.
개발 시간 단축: 쉽게 사용할 수 있는 라이브러리를 활용함으로써, 공통 기능에 대해 휙휙 돌리기보다는 API 테스트의 핵심 로직에 집중할 수 있습니다.
협업 개선: 팀 내에서 라이브러리를 공유하면 일관성을 촉진하고 모든 사람이 동일한 도구 세트로 작업하여 협업 및 지식 공유를 간소화합니다.

외부 라이브러리 가져오기: 두 가지 강력한 방법

Postman은 외부 라이브러리를 통합하기 위한 두 가지 주요 방법을 제공합니다:

1. CDN(콘텐츠 배달 네트워크)에서 가져오기:

많은 라이브러리가 jsDelivr 또는 cdnjs와 같은 플랫폼에 호스팅된 CDN 버전을 제공합니다. 이를 통해 pm.sendRequest 함수를 사용하여 Postman에 라이브러리 코드를 직접 가져올 수 있습니다. 방법은 다음과 같습니다:

CDN URL 찾기: 선택한 라이브러리의 CDN 링크를 찾습니다(보통 문서 페이지에 제공됨).
프리 요청 스크립트 작성: 요청의 "프리 요청 스크립트" 탭 내에서 pm.sendRequest를 사용하여 CDN URL에서 라이브러리 코드를 가져옵니다.
저장 및 평가: 가져온 응답을 컬렉션 변수로 저장하고 eval 함수를 사용하여 라이브러리 코드를 실행하여, Postman 환경 내에서 해당 함수에 접근할 수 있습니다.

2. 컬렉션 변수에서 로드하기:

매번 API 요청을 피하고 싶다면, 컬렉션 변수 내에 라이브러리 코드를 직접 저장할 수 있습니다. 과정은 다음과 같습니다:

코드 복사 및 붙여넣기: 라이브러리의 JavaScript 코드를 찾습니다(보통 GitHub 리포지토리에서 찾을 수 있습니다).
컬렉션 변수 만들기: 컬렉션 내에서 새 변수를 만들고 그 안에 라이브러리 코드를 붙여넣습니다.

IIFE(즉시 호출 함수 표현식) 사용: Postman 스크립트 내에서, IIFE를 사용하여 라이브러리 코드를 감싸주어, Postman 샌드박스 내에서 해당 메서드에 접근 가능하게 합니다.

양쪽 방법은 각자 장점이 있습니다. CDN에서 가져오는 방법은 컬렉션 코드를 깨끗하게 유지해주고, 변수를 사용하여 로드하는 방법은 추가 API 요청의 필요성을 없애줍니다. 여러분의 워크플로에 가장 적합한 접근 방식을 선택하세요!

Apidog에서 외부 라이브러리 가져오는 방법

Apidog는 API 생애주기를 간소화하도록 설계된 통합 협업 플랫폼입니다. 이 플랫폼은 Postman, Swagger, Mock 및 JMeter와 같은 여러 도구의 기능을 하나로 결합했습니다.

button

Apidog은 Javascript 기반 스크립트 엔진을 포함하고 있습니다. 스크립트를 사용하여 API 요청이나 컬렉션 테스트에 동적 행동을 추가할 수 있습니다.

내장되어 있지 않지만 npm에서 동적으로 사용할 수 있도록 만들어진 라이브러리를 가져오기 위해 $$.liveRequire 함수를 사용할 수 있습니다. 순수 js 라이브러리만 지원되며, 브라우저 측 작업을 지원하기 위해 'browser'라는 단어가 포함된 라이브러리를 선호합니다. C/C++와 같은 언어 확장이 포함된 라이브러리는 로드가 지원되지 않으며 시간이 초과되거나 예외가 발생할 수 있습니다.

아래는 내장되지 않은 JS 클래스 라이브러리를 사용하는 예입니다.

// 단일 npm 라이브러리 가져오기: camelcase
$$.liveRequire("camelcase", (camelCase) => {
  camelCase("foo-bar"); // => 'fooBar'
});

// 여러 npm 라이브러리 가져오기: camelcase
$$.liveRequire(["camelcase", "md5"], (camelCase, md5) => {
  camelCase("foo-bar"); // => 'fooBar'
  md5("message"); // => '78e731027d8fd50ed642340b7c9a63b3'
});

Apidog 스크립트 구문은 Postman 스크립트 구문과 100% 호환됩니다. Postman 스크립트를 Apidog로 쉽게 이전할 수 있습니다.

후처리 스크립트를 사용하여 라이브러리를 가져오기 위한 사용자 정의 스크립트를 작성합니다.

2. 요청을 보내고 콘솔 탭에서 응답을 분석합니다.

API 테스트를 강력하게 만들어 줄 인기 외부 라이브러리

이제 사용 방법을 알았으니, Postman 경험을 크게 향상시킬 수 있는 인기 외부 라이브러리를 살펴보겠습니다:

Lodash: 이 다재다능한 라이브러리는 데이터 조작을 위한 다양한 유틸리티 함수를 제공하여 복잡한 변환을 쉽게 처리할 수 있습니다.
Moment.js: 날짜 및 시간 작업을 하고 계신가요? Moment.js는 날짜를 파싱하고 형식을 지정하며 계산을 수행하는 직관적인 API를 제공하여, 날짜 중심의 API에 큰 도움이 됩니다.
Chai.js: 이 단언 라이브러리는 API 응답을 검증하기 위해 명확하고 간결한 단언을 작성할 수 있도록 도와주어, 테스트가 강력하고 신뢰할 수 있도록 보장합니다.
Faker.js: 현실적인 테스트 데이터가 필요하신가요? Faker.js는 이름, 주소, 이메일 등을 위한 현실적인 데이터를 생성하여 포괄적인 테스트 시나리오를 만들어 내는 데 적합합니다.

이들은 몇 가지 예에 불과하며, 외부 라이브러리의 세계는 방대합니다! 여러분의 API 테스트 요구에 완벽하게 맞는 도구를 찾기 위해 탐색하고 실험해보세요.

예시: Apidog와 Postman에서 라이브러리를 활용하기

우리의 이해를 강화하기 위해, Apidog Postman에서 인기 라이브러리를 사용하는 구체적인 예를 살펴보겠습니다:

Moment.js를 통한 날짜 조작: 날짜 포맷이 필요한 API 엔드포인트를 테스트한다고 상상해 보세요. Moment.js가 구해줍니다! 위에서 언급한 방법 중 하나를 사용하여 가져온 다음, Postman 테스트 내에서 날짜를 포맷하고 파싱하며 계산을 수행하기 위해 직관적인 함수를 활용할 수 있습니다.

Lodash를 통한 데이터 변환: 복잡한 JSON 데이터 구조를 다루고 계신가요? Lodash는 데이터를 필터링, 정렬, 그룹화 및 변환하기 위한 다양한 유틸리티 함수를 제공합니다. Postman 환경 내에 Lodash를 통합하여 데이터 처리 작업을 간소화하고 더 간결하고 표현력 있는 테스트를 작성하세요.

매끄러운 라이브러리 통합을 위한 프로 팁

외부 라이브러리의 세계를 탐구하는 동안 다음 팁을 염두에 두세요:

버전 호환성: 사용 중인 라이브러리 버전이 Postman 환경과 호환되는지 확인하여 예기치 않은 문제를 방지하세요.
코드 조직: Postman 스크립트 내에서 깔끔하고 조직적인 코드를 유지하여 가독성과 유지보수성을 높입니다.
커뮤니티 리소스: 특정 라이브러리에 전념하는 온라인 리소스와 커뮤니티를 활용하세요. 귀중한 튜토리얼, 예제 및 문제 해결 가이드를 자주 찾을 수 있습니다.

결론

Postman과 Apidog에 외부 라이브러리를 추가하는 것은 간단한 과정으로, API 테스트 및 개발 워크플로를 크게 향상시킬 수 있습니다. 이러한 라이브러리를 통합함으로써, 추가 기능을 활용하고 중복을 줄이며 API 호출의 효율성을 높일 수 있습니다. 통합할 라이브러리의 문서를 이해하고 현재 설정과 호환되는지 확인하는 것이 핵심임을 기억하세요. 즐거운 테스트와 개발 되세요!