Postman 컬렉션
각 계약에는 샌드박스 URL과 예제 요청 본문이 미리 구성된 Postman 컬렉션이 제공됩니다. 컬렉션을 가져오고, 자격 증명을 입력하면 코드를 작성하지 않고도 모든 엔드포인트를 호출할 수 있습니다.
계약별 컬렉션
| 계약 | 컬렉션 | 비고 |
|---|---|---|
| 인증 | 다운로드 | 아래 파일을 다운로드하여 Postman으로 가져온 후, "service_account", "tenant_id", "secret_key" 파라미터 값을 교체하여 요청을 테스트하세요. |
| API | 다운로드 | 프로세스 생성(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로 변경. |
API — 각 요청을 열고 Authorization: Bearer 및 APIKEY 헤더 값을 자신의 자격 증명으로 교체하세요.
- 인증 요청 실행 — 사전 요청 스크립트가 자동으로 JWT 어서션을 생성하고
{{jwt_token}}에 저장합니다.
사전 요청 스크립트
인증 컬렉션만 사전 요청 스크립트를 포함합니다. 이 스크립트는:
- 컬렉션 변수에서
service_account,tenant_id,secret_key,base_path를 읽습니다. - 임베디드 KJUR 라이브러리를 사용하여 JWT 어서션을 생성하고 서명(RS256)합니다.
- 서명된 토큰을
{{jwt_token}}에 저장하며, 이는 자동으로 요청 본문에 주입됩니다.
API 컬렉션에는 사전 요청 스크립트가 없습니다 — 자격 증명은 요청 헤더에 직접 설정됩니다.