안녕하세요! API에 관심이 있고 Postman을 사용해 본 적이 있다면, 프리 요청 스크립트에 대해 들어본 적이 있을 것입니다. 그런데 프리 요청 스크립트란 정확히 무엇일까요? 그리고 이를 통해 API 테스트를 어떻게 향상시킬 수 있을까요? 함께 알아보도록 하겠습니다!
프리 요청 스크립트란 무엇인가요?
프리 요청 스크립트는 Postman 및 Apidog과 같은 API 테스트 도구의 기능입니다. 본질적으로 API 요청이 전송되기 전에 실행되는 코드 블록입니다.
이 스크립트는 JavaScript로 작성되며 API 요청을 위한 환경을 준비할 수 있게 해줍니다. 프리 요청 스크립트를 사용하여 변수를 설정하거나 업데이트하고, 데이터를 생성하며, 요청에 매개변수를 추가하는 등 여러 작업을 수행할 수 있습니다.
프리 요청 스크립트의 주요 목적은 수동으로 각 요청을 위해 수행해야 할 작업을 자동화하는 것입니다. 이는 API 테스트 프로세스의 효율성과 정확성을 크게 향상시킬 수 있습니다.
Postman 소개
Postman은 API(응용 프로그램 프로그래밍 인터페이스) 플랫폼으로, API 생애 주기의 각 단계를 단순화하고 협업을 원활하게 하여 더 나은 API를 보다 빠르게 생성할 수 있도록 도와줍니다.

프리 요청 스크립트를 사용하는 이유는 무엇인가요?
프리 요청 스크립트는 API 테스트에서 여러 가지 이유로 강력한 도구입니다:
자동화: 프리 요청 스크립트는 요청을 보낼 때마다 수동으로 수행해야 하는 작업을 자동화할 수 있게 해줍니다. 이를 통해 상당한 시간과 노력을 절약할 수 있습니다.
동적 데이터: 프리 요청 스크립트를 사용하면 요청을 위한 동적 데이터를 생성할 수 있습니다. 예를 들어, 요청에 고유 ID 또는 현재 타임스탬프를 포함해야 할 수 있습니다. 매번 이러한 값을 수동으로 업데이트하는 대신 프리 요청 스크립트를 사용하여 자동으로 생성하고 포함할 수 있습니다.
요청 수정: 프리 요청 스크립트를 사용하여 요청이 전송되기 전에 프로그래밍적으로 요청을 수정할 수 있습니다. 이는 특정 조건에 따라 요청 매개변수나 헤더를 변경해야 할 때 유용할 수 있습니다.
환경 설정: 프리 요청 스크립트를 사용하여 요청을 위한 올바른 환경을 설정할 수 있습니다. 예를 들어, 요청을 보내기 전에 특정 환경 변수를 설정하거나 특정 데이터를 초기화해야 할 수 있습니다.
테스트 및 디버깅: 프리 요청 스크립트는 테스트 및 디버깅에도 사용할 수 있습니다. 요청 데이터를 검증하거나 디버깅 목적으로 정보를 기록하거나 다양한 시나리오를 시뮬레이션하는 스크립트를 작성할 수 있습니다.
요약하면, 프리 요청 스크립트는 API 테스트 프로세스의 유연성과 효율성을 향상시켜, 모든 API 개발 및 테스트 환경에서 귀중한 기능이 됩니다.
Postman에서 프리 요청 스크립트 사용하는 방법
Postman에서 프리 요청 스크립트를 사용하는 것은 매우 간단합니다. 단계별 가이드는 다음과 같습니다:
- Postman을 열고 전송하고 싶은 요청을 선택합니다.

2. “프리 요청 스크립트” 탭을 클릭합니다.

3. 편집기에서 스크립트를 작성합니다. JavaScript를 사용할 수 있으며 Postman Sandbox, 즉 JavaScript 실행 환경에 접근할 수 있습니다.

간단한 예제
Unix 형식의 타임스탬프가 필요한 API를 테스트한다고 가정해 봅시다. 현재 타임스탬프를 찾아서 수동으로 입력하는 대신 프리 요청 스크립트를 사용하여 이를 처리할 수 있습니다:
let timestamp = Math.floor(Date.now() / 1000);
pm.environment.set("timestamp", timestamp);
이 스크립트는 현재 날짜와 시간을 가져와 Unix 형식(1970년 1월 1일 이후 초 수)으로 변환하고, 이를 "timestamp"라는 환경 변수에 저장합니다. 이제 요청에서 필요한 곳에 {{timestamp}}
를 사용할 수 있습니다.
Apidog에서 프리 요청 스크립트 사용하는 방법
Apidog에서의 프리 요청 스크립트는 Postman의 것과 유사합니다. 이는 API 요청이 전송되기 전에 실행되는 JavaScript 코드 조각입니다. 요청 헤더에 타임스탬프를 포함하거나 URL 매개변수에 임의의 알파벳 숫자 문자열을 전송할 때 유용할 수 있습니다.
Apidog에서 프리 요청 스크립트를 사용하는 방법에 대한 단계별 가이드는 다음과 같습니다:
- Apidog을 열고 전송하고 싶은 요청을 선택합니다.

2. “프리프로세서 스크립트” 탭을 클릭합니다.

3. 편집기에서 스크립트를 작성합니다. JavaScript를 사용할 수 있으며 Apidog Sandbox에 접근할 수 있습니다.

“전송” 버튼을 클릭하고 스크립트의 마법을 지켜보세요!
환경 변수를 설정할 때는 해당 환경이 선택되어 있어야 한다는 것을 기억하세요. 프리프로세서 스크립트는 JavaScript로 작성되며 포스트프로세서 스크립트와 정확히 동일한 구문을 가집니다. 그러나 pm.response 객체는 없습니다.
결론
결론적으로, Postman의 프리 요청 스크립트는 APIdog와 같은 API 테스트 도구의 기능과 마찬가지로 요청이 전송되기 직전에 다양한 측면을 조작할 수 있는 강력한 기능입니다. 이는 JavaScript로 작성되며 변수 값을 설정하고, 코드를 디버깅하고, 일반적인 작업을 자동화하는 데 사용할 수 있습니다. 이것은 동적이고 유연하며 효율적인 API 테스트 워크플로우를 만들고자 하는 개발자에게 매우 유용한 도구가 됩니다. Postman이나 APIdog를 사용하든 이러한 기능은 API를 테스트하고 디버그하는 능력을 크게 향상시킬 수 있으며, 개발 프로세스를 더욱 원활하고 효율적으로 만들어줍니다. 행복한 테스트 되세요!