Postman Collections 가져오기 및 내보내기 방법 (2026)
Postman 컬렉션 관리를 위한 단계별 가이드
Hypereal로 구축 시작하기
단일 API를 통해 Kling, Flux, Sora, Veo 등에 액세스하세요. 무료 크레딧으로 시작하고 수백만으로 확장하세요.
신용카드 불필요 • 10만 명 이상의 개발자 • 엔터프라이즈 지원
Postman Collection 내보내기 및 가져오기 방법 (2026)
Postman Collection은 API 요청을 구성, 공유 및 문서화하는 표준 방식입니다. 팀원과 엔드포인트를 공유하거나, 워크스페이스 간에 데이터를 마이그레이션하거나, 작업을 백업하거나, CI/CD 파이프라인을 설정할 때 Collection을 효율적으로 내보내고 가져오는 방법을 아는 것은 필수적입니다.
이 가이드는 데스크톱 앱, Postman API, CLI 및 일반적인 포맷을 포함하여 2026년 기준 Postman Collection을 내보내고 가져오는 모든 방법을 다룹니다.
Postman Collection이란 무엇인가요?
Postman Collection은 일련의 API 요청과 해당 설정이 포함된 JSON 파일입니다:
- 요청 URL, 메서드, 헤더 및 본문(Body)
- Pre-request 스크립트 및 테스트 스크립트
- 변수 및 인증 설정
- 폴더 구조 및 문서화
- 응답 예시(Example responses)
Collection은 .json 포맷을 사용하며 Postman의 Collection v2.1 스키마를 따릅니다.
Collection 내보내기 (Exporting)
방법 1: Postman 데스크톱 앱에서 내보내기
Collection을 내보내는 가장 간단한 방법입니다:
- Postman을 열고 왼쪽 사이드바에서 Collections로 이동합니다.
- Collection 이름 옆의 점 세 개(...)를 클릭합니다.
- Export를 선택합니다.
- 포맷을 선택합니다:
- Collection v2.1 (권장) -- 현재 표준 포맷
- Collection v2.0 -- 이전 포맷, 더 넓은 호환성
- Export를 클릭하고
.json파일을 저장할 위치를 선택합니다.
방법 2: Postman API를 통해 내보내기
Postman API를 사용하여 프로그래밍 방식으로 Collection을 내보낼 수 있습니다:
# Postman API 키는 다음에서 확인하세요: https://web.postman.co/settings/me/api-keys
# 모든 Collection 목록 가져오기
curl -s -X GET "https://api.getpostman.com/collections" \
-H "X-Api-Key: YOUR_POSTMAN_API_KEY" | jq '.collections[] | {name, uid}'
# UID를 사용하여 특정 Collection 내보내기
curl -s -X GET "https://api.getpostman.com/collections/YOUR_COLLECTION_UID" \
-H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
-o my-collection.json
# 모든 Collection을 내보내는 Python 스크립트
import requests
import json
import os
API_KEY = "YOUR_POSTMAN_API_KEY"
HEADERS = {"X-Api-Key": API_KEY}
BASE_URL = "https://api.getpostman.com"
# 모든 Collection 가져오기
response = requests.get(f"{BASE_URL}/collections", headers=HEADERS)
collections = response.json()["collections"]
# 각 Collection 내보내기
os.makedirs("postman_backup", exist_ok=True)
for col in collections:
uid = col["uid"]
name = col["name"].replace(" ", "_").replace("/", "_")
detail = requests.get(f"{BASE_URL}/collections/{uid}", headers=HEADERS)
with open(f"postman_backup/{name}.json", "w") as f:
json.dump(detail.json(), f, indent=2)
print(f"Exported: {name}")
방법 3: Postman CLI (Newman)를 통해 내보내기
Newman은 Postman의 커맨드라인 도구입니다. 주로 Collection을 실행하는 데 사용되지만, 내보내기 워크플로우를 위해 API와 결합하여 사용할 수 있습니다:
# Newman 설치
npm install -g newman
# Collection 내보내기와 실행을 한 번에 수행
curl -s "https://api.getpostman.com/collections/YOUR_COLLECTION_UID" \
-H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
-o collection.json
# 내보낸 Collection 실행
newman run collection.json --environment env.json
방법 4: 공개 링크(Public Link)로 공유
파일 내보내기 없이 빠르게 공유하는 방법입니다:
- Collection 옆의 점 세 개를 클릭합니다.
- Share를 선택합니다.
- Get public link를 선택합니다.
- 링크를 복사하여 공유합니다.
링크가 있는 사람은 누구나 해당 Collection을 보고 가져올 수 있습니다.
Collection 가져오기 (Importing)
방법 1: JSON 파일 가져오기
가장 일반적인 가져오기 방법입니다:
- Postman을 엽니다.
- 왼쪽 상단 모서리의 Import를 클릭합니다 (또는 Ctrl/Cmd + O 누름).
- 다음 중 하나를 선택합니다:
.json파일을 드래그 앤 드롭합니다.- Upload files -- 파일을 찾아 선택합니다.
- Paste raw text -- JSON 콘텐츠를 직접 붙여넣습니다.
- Postman이 가져올 내용의 미리보기를 보여줍니다.
- Import를 클릭하여 확인합니다.
방법 2: URL에서 가져오기
URL에서 직접 Collection을 가져옵니다:
- Postman에서 Import를 클릭합니다.
- Link 탭을 선택합니다.
- Collection JSON 파일의 URL(예: GitHub, Gist 또는 공개 Postman 링크)을 붙여넣습니다.
- Continue를 클릭한 후 Import를 클릭합니다.
# 작동하는 예시 URL:
https://raw.githubusercontent.com/user/repo/main/collection.json
https://api.getpostman.com/collections/UID?apikey=KEY
https://www.getpostman.com/collections/SHARE_ID
방법 3: cURL에서 가져오기
cURL 명령어를 사용하여 개별 요청을 가져올 수 있습니다:
- Import를 클릭합니다.
- Raw text를 선택합니다.
- cURL 명령어를 붙여넣습니다:
curl -X POST "https://api.example.com/users" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer token123" \
-d '{"name": "John", "email": "john@example.com"}'
- Postman이 이를 자동으로 요청으로 변환합니다.
방법 4: OpenAPI/Swagger에서 가져오기
OpenAPI 사양을 통해 전체 API를 가져옵니다:
- Import를 클릭합니다.
openapi.yaml또는swagger.json파일을 업로드합니다.- Postman이 모든 엔드포인트가 포함된 완전한 Collection을 생성합니다.
# 또는 URL에서 가져오기
# Import > Link 탭에 이 URL을 붙여넣으세요:
https://petstore.swagger.io/v2/swagger.json
Postman 지원 포맷:
- OpenAPI 3.0 및 3.1 (YAML 및 JSON)
- Swagger 2.0
- GraphQL 스키마
- RAML
- WSDL
방법 5: Postman API를 통해 가져오기
# API를 통해 Collection 가져오기
curl -X POST "https://api.getpostman.com/collections" \
-H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
-H "Content-Type: application/json" \
-d @my-collection.json
# Python: Collection 가져오기
import requests
import json
API_KEY = "YOUR_POSTMAN_API_KEY"
with open("my-collection.json") as f:
collection_data = json.load(f)
response = requests.post(
"https://api.getpostman.com/collections",
headers={
"X-Api-Key": API_KEY,
"Content-Type": "application/json"
},
json=collection_data
)
print(response.json())
환경 변수(Environments) 내보내기 및 가져오기
Collection은 종종 환경 변수에 의존합니다. 환경 변수도 함께 내보내야 합니다.
환경 변수 내보내기
- 왼쪽 사이드바에서 Environments를 클릭합니다.
- 환경 이름 옆의 점 세 개를 클릭합니다.
- Export를 선택합니다.
.json파일을 저장합니다.
환경 변수 가져오기
- Import를 클릭합니다.
- 환경 JSON 파일을 업로드합니다.
- Postman이 해당 환경을 Environments 목록에 추가합니다.
환경 파일 포맷 예시
{
"name": "Production",
"values": [
{
"key": "base_url",
"value": "https://api.example.com",
"type": "default",
"enabled": true
},
{
"key": "api_key",
"value": "sk-your-key-here",
"type": "secret",
"enabled": true
}
]
}
경고: 내보낸 환경 파일에는 시크릿 값이 평문으로 포함됩니다. 공유 전 민감한 값은 제거하세요.
지원되는 가져오기/내보내기 포맷
| 포맷 | 가져오기(Import) | 내보내기(Export) | 비고 |
|---|---|---|---|
| Postman Collection v2.1 | 지원 | 지원 | 권장 포맷 |
| Postman Collection v2.0 | 지원 | 지원 | 이전 포맷 |
| OpenAPI 3.0/3.1 | 지원 | 지원 | 업계 표준 |
| Swagger 2.0 | 지원 | 지원 안 함 | 기존 포맷 |
| cURL | 지원 | 지원 (요청별) | 단일 요청 전용 |
| HAR | 지원 | 지원 안 함 | HTTP Archive 포맷 |
| GraphQL | 지원 | 지원 안 함 | 스키마 가져오기 |
| RAML | 지원 | 지원 안 함 | RESTful API 모델링 |
| WSDL | 지원 | 지원 안 함 | SOAP API |
모범 사례 (Best Practices)
Collection 버전 관리
Collection을 코드와 함께 Git에 저장하세요:
# 프로젝트 구조
my-api/
├── src/
├── tests/
├── postman/
│ ├── collection.json
│ ├── environment.dev.json
│ ├── environment.staging.json
│ └── environment.prod.json
├── package.json
└── README.md
Collection 백업 자동화
#!/bin/bash
# backup-postman.sh - cron을 통해 매주 실행
API_KEY="YOUR_POSTMAN_API_KEY"
BACKUP_DIR="./postman-backups/$(date +%Y-%m-%d)"
mkdir -p "$BACKUP_DIR"
# 모든 Collection UID 가져오기
COLLECTIONS=$(curl -s "https://api.getpostman.com/collections" \
-H "X-Api-Key: $API_KEY" | jq -r '.collections[] | .uid')
for UID in $COLLECTIONS; do
NAME=$(curl -s "https://api.getpostman.com/collections/$UID" \
-H "X-Api-Key: $API_KEY" | jq -r '.collection.info.name' | tr ' /' '__')
curl -s "https://api.getpostman.com/collections/$UID" \
-H "X-Api-Key: $API_KEY" \
-o "$BACKUP_DIR/${NAME}.json"
echo "Backed up: $NAME"
done
공유 전 시크릿 제거
# strip-secrets.py - 공유 전 민감한 값을 제거
import json
import sys
with open(sys.argv[1]) as f:
env = json.load(f)
for val in env.get("values", []):
if val.get("type") == "secret":
val["value"] = "REPLACE_ME"
with open(sys.argv[1].replace(".json", "-clean.json"), "w") as f:
json.dump(env, f, indent=2)
문제 해결 (Troubleshooting)
| 문제 | 해결 방법 |
|---|---|
| "invalid format" 오류로 가져오기 실패 | JSON이 유효한지 확인하세요. JSON 유효성 검사기를 사용하세요. |
변수가 {{undefined}}로 표시됨 |
Collection과 함께 환경 파일을 가져오세요. |
| Collection v2.0 및 v2.1 불일치 | v2.1 포맷으로 다시 내보내세요. |
| 대규모 Collection 가져오기가 느림 | 기능별로 더 작은 Collection으로 나눕니다. |
| 공유 링크 만료됨 | Collection에서 새 공개 링크를 생성하세요. |
| 가져온 후 스크립트가 실행되지 않음 | 스크립트 종속성이 문서화되어 있는지 확인하세요. |
자주 묻는 질문 (FAQ)
Postman Collection을 다른 도구로 가져올 수 있나요? 네. Insomnia, Thunder Client (VS Code), Bruno와 같은 도구는 Postman Collection 포맷을 지원합니다. OpenAPI 내보내기는 거의 모든 API 도구와 호환됩니다.
Collection 내보내기에 크기 제한이 있나요? Postman은 엄격한 크기 제한을 두지 않지만, 매우 큰 Collection(100MB 이상)은 가져올 때 느려질 수 있습니다. 분할하는 것이 좋습니다.
두 개의 Collection을 병합할 수 있나요? 내장된 병합 기능은 없습니다. 둘 다 JSON으로 내보낸 다음 수동이나 스크립트로 결합한 후 다시 가져오세요.
내보낸 Collection에 테스트 결과가 포함되나요? 아니요. 내보내기에는 테스트 스크립트는 포함되지만 과거의 테스트 결과는 포함되지 않습니다. CI/CD 테스트 실행을 위해 Newman을 사용하세요.
마무리하며
사용 가능한 방법을 숙지하고 나면 Postman Collection을 내보내고 가져오는 과정은 매우 간단합니다. 팀 워크플로우를 위해서는 Postman API를 사용하여 자동화하세요. 버전 관리를 위해서는 JSON으로 내보내 Git에 커밋하세요. 도구 간 호환성을 위해서는 OpenAPI 포맷을 사용하세요.
이미지 생성, 비디오 제작 또는 아바타 합성을 위한 AI 기반 API를 테스트하고 있다면, Hypereal AI를 무료로 체험해 보세요. 카드 등록 없이 35크레딧을 제공합니다. 해당 API는 쉬운 테스트를 위해 Postman용 Collection을 함께 제공합니다.
