---
title: Postman 컬렉션
description: 인증, Web & SDK, API 계약을 위한 바로 사용 가능한 Postman 컬렉션.
canonical: https://developer.unico.io/ko/dual-api/developers/api-reference/postman
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- [API 레퍼런스](/ko/dual-api/developers/api-reference/)
- Postman 컬렉션

**이 페이지에서# Postman 컬렉션

각 계약에는 샌드박스 URL과 예제 요청 본문이 미리 구성된 Postman 컬렉션이 제공됩니다. 컬렉션을 가져오고, 자격 증명을 입력하면 코드를 작성하지 않고도 모든 엔드포인트를 호출할 수 있습니다.
### 계약별 컬렉션​

계약컬렉션비고**인증**[다운로드](/postman/oauth2.postman_collection.json)아래 파일을 다운로드하여 Postman으로 가져온 후, "service_account", "tenant_id", "secret_key" 파라미터 값을 교체하여 요청을 테스트하세요.**Web & SDK**[다운로드](/postman/web-sdk-integration.postman_collection.json)프로세스 생성, GET 프로세스, GET 증거, GET PDF 포함.**API**[다운로드](/postman/api-integration.postman_collection.json)프로세스 생성(POST) 및 GET 프로세스 포함.
### 설정​

통합 중인 계약의 **컬렉션을 다운로드**하세요.
Postman에서 **가져오기**: `File > Import > Upload Files`.
컬렉션에 따라 **자격 증명을 구성**하세요:

**인증** — 컬렉션을 열고 변수 탭으로 이동하여 다음을 입력하세요:
변수값`service_account`서비스 계정 이름.`tenant_id`테넌트 ID.`secret_key`개인 키(PEM 형식).`base_path`토큰 엔드포인트 호스트. 기본값은 UAT(`https://identityhomolog.acesso.io`); 프로덕션의 경우 `https://identity.acesso.io`로 변경.
**Web & SDK** — 각 요청을 열고 `Authorization: Bearer` 값을 자신의 액세스 토큰으로 교체하세요.
**API** — 각 요청을 열고 `Authorization: Bearer` 및 `APIKEY` 헤더 값을 자신의 자격 증명으로 교체하세요.

**인증 요청 실행** — 사전 요청 스크립트가 자동으로 JWT 어서션을 생성하고 `{{jwt_token}}`에 저장합니다.

### 사전 요청 스크립트​

**인증** 컬렉션만 사전 요청 스크립트를 포함합니다. 이 스크립트는:

컬렉션 변수에서 `service_account`, `tenant_id`, `secret_key`, `base_path`를 읽습니다.
임베디드 KJUR 라이브러리를 사용하여 JWT 어서션을 생성하고 서명(RS256)합니다.
서명된 토큰을 `{{jwt_token}}`에 저장하며, 이는 자동으로 요청 본문에 주입됩니다.

Web & SDK 및 API 컬렉션에는 사전 요청 스크립트가 없습니다 — 자격 증명은 요청 헤더에 직접 설정됩니다.
### 다음 단계​

[인증](/ko/dual-api/developers/api-reference/authentication) — 컬렉션에 필요한 자격 증명 생성.
[Web & SDK 개요](/ko/dual-api/developers/api-reference/web-sdk) — Web & SDK 컬렉션 컨텍스트.
[API 개요](/ko/dual-api/developers/api-reference/api) — API 컬렉션 컨텍스트.
마지막 업데이트 2026년 10월 8일**에