SaaS API전자계약 API
GET /ai/contract/{contractId}/audit
계약서의 감사 추적 로그를 조회합니다.
감사 추적 조회
계약서의 모든 감사 추적 로그를 조회합니다. 계약서 열람, OTP 인증, 서명 등 모든 이벤트가 시간순으로 기록됩니다.
| 항목 | 값 |
|---|---|
| 메서드 | GET |
| 경로 | /ai/contract/{contractId}/audit |
| 인증 | Bearer Token (관리자) |
요청
GET /ai/contract/1/audit HTTP/1.1
Host: api.glowb.com
Authorization: Bearer {access_token}curl -X GET "https://api.glowb.com/ai/contract/1/audit" \
-H "Authorization: Bearer {access_token}"const response = await fetch('/ai/contract/1/audit', {
headers: {
'Authorization': `Bearer ${accessToken}`,
},
});
const result = await response.json();Path Parameters
Prop
Type
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "감사 추적 조회가 완료되었습니다.",
"data": [
{
"id": 1,
"eventType": "CREATED",
"eventDisplayName": "계약서 생성",
"actorId": "admin001",
"actorRole": "ADMIN",
"ipAddress": "192.168.1.1",
"detail": null,
"createdAt": "2026-02-25T10:00:00"
},
{
"id": 2,
"eventType": "SENT",
"eventDisplayName": "계약서 발송",
"actorId": "admin001",
"actorRole": "ADMIN",
"ipAddress": "192.168.1.1",
"detail": null,
"createdAt": "2026-02-25T10:00:01"
},
{
"id": 3,
"eventType": "OPENED",
"eventDisplayName": "계약서 최초 열람",
"actorId": "creator001",
"actorRole": "CREATOR",
"ipAddress": "10.0.0.1",
"detail": null,
"createdAt": "2026-02-25T14:30:00"
},
{
"id": 4,
"eventType": "SIGNED",
"eventDisplayName": "서명 완료",
"actorId": "creator001",
"actorRole": "CREATOR",
"ipAddress": "10.0.0.1",
"detail": null,
"createdAt": "2026-02-26T11:00:00"
},
{
"id": 5,
"eventType": "PDF_GENERATED",
"eventDisplayName": "PDF 생성",
"actorId": "creator001",
"actorRole": "CREATOR",
"ipAddress": "10.0.0.1",
"detail": "PDF Hash: a1b2c3d4e5f6...",
"createdAt": "2026-02-26T11:00:01"
}
]
}응답 필드
Prop
Type
이벤트 타입
| 코드 | 표시명 | 설명 |
|---|---|---|
CREATED | 계약서 생성 | 관리자가 계약서 생성 |
SENT | 계약서 발송 | 관리자가 크리에이터에게 발송 |
OPENED | 계약서 최초 열람 | 크리에이터가 처음 열람 |
VIEWED | 계약서 열람 | 크리에이터 재열람 |
FORM_FILLED | 정보 입력 | 크리에이터 정보 입력 완료 |
OTP_REQUESTED | OTP 발송 | SMS OTP 인증번호 발송 |
OTP_VERIFIED | OTP 인증 | OTP 인증 성공 |
SIGNED | 서명 완료 | 전자서명 제출 |
PDF_GENERATED | PDF 생성 | 서명 포함 PDF 생성 |
ADMIN_VIEWED | 관리자 목록 조회 | 관리자 조회 |
AUDIT_TRAIL_VIEWED | 감사 추적 조회 | 감사 로그 조회 |
DOCUMENT_UPLOADED | 서류 첨부 | 신분증/사업자등록증/통장사본 첨부 |