For the complete documentation index, see llms.txt. This page is also available as Markdown.

체결된 계약서 및 감사추적 인증서 다운로드 URL 조회 API

체결된 전자서명 계약서의 날인본과 감사추적 인증서 다운로드 URL을 조회할 수 있는 API입니다.

GET kit-api/v1/contracts/download/concluded-contract-files-url

Method: GET Endpoint: kit-api/v1/contracts/download/concluded-contract-files-url

Example

...kit-api/v1/contracts/download/concluded-contract-files-url?uuid=ed976505-bcbd-47bd-913d-f4cde05dea7a
...kit-api/v1/contracts/download/concluded-contract-files-url?customKey=CN-2025-001

Request Query

Key
Description
Required

uuid

계약서 UUID로 체결 파일을 조회하는 경우 사용

조건부 yes (둘 중에 하나 필수)

customKey

계약서 커스텀 키로 체결 파일을 조회하는 경우 사용

조건부 yes (둘 중에 하나 필수)

참고: uuidcustomKey는 모두 계약서 기준 값입니다. 둘 중 하나만 전달해야 합니다.

Response

감사추적 인증서는 체결 직후 아직 생성 준비가 완료되지 않았을 수 있습니다. 이 경우 SIGNATURE_CERTIFICATE_NOT_READY 에러가 반환되며, 잠시 후 같은 요청을 다시 시도해 주세요.

Status Code
Error Code
Description

400

DELETED_CONTRACT

삭제된 계약서인 경우

401

UNAUTHORIZED_API_KEY

API Key가 전달되지 않은 경우

403

NOT_MATCHES_PERMISSION_USER

API Key에 계약서 API 권한을 가진 사용자가 연결되어 있지 않은 경우

403

FORBIDDEN_BUSINESS

해당 계약서의 워크스페이스 권한이 없는 경우

403

FORBIDDEN_PERMISSION

현재 팀에 해당 계약서 접근 권한이 없는 경우

404

NOT_FOUND_BUSINESS

API Key에 연결된 워크스페이스가 없는 경우

404

NOT_FOUND_CONTRACT

계약서를 조회할 수 없는 경우

404

CONTRACT_CONCLUDED_FILE_NOT_FOUND

계약서 체결본이 없는 경우

404

NOT_FOUND_SIGNATURE

계약서에 연결된 전자서명 정보가 없는 경우

409

SIGNATURE_CERTIFICATE_NOT_READY

감사추적 인증서 생성 준비가 아직 완료되지 않은 경우

Last updated