메인 콘텐츠로 건너뛰기

Postman 컬렉션

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

계약별 컬렉션​

계약컬렉션비고
인증다운로드아래 파일을 다운로드하여 Postman으로 가져온 후, "service_account", "tenant_id", "secret_key" 파라미터 값을 교체하여 요청을 테스트하세요.
Web & SDK다운로드프로세스 생성, GET 프로세스, GET 증거, GET PDF 포함.
API다운로드프로세스 생성(POST) 및 GET 프로세스 포함.

설정​

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

인증 — 컬렉션을 열고 변수 탭으로 이동하여 다음을 입력하세요:

변수값
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 헤더 값을 자신의 자격 증명으로 교체하세요.

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

사전 요청 스크립트​

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

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

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

다음 단계​

마지막 업데이트 에