전자계약 API 개요
전자계약 발송, 조회, 서명 관련 API
크리에이터와 브랜드 간의 전자계약을 관리하는 API입니다.
DRAFT (작성중)
↓ 관리자가 계약서 발송
SENT (발송됨)
↓ 크리에이터가 최초 열람
OPENED (열람됨)
↓ 크리에이터가 정보 입력
FILLED (작성완료)
↓ SMS OTP 본인인증 완료
OTP_VERIFIED (본인인증완료)
↓ 서명 제출 → PDF 생성
SIGNED (서명완료)
| 메서드 | 경로 | 설명 |
|---|
POST | /ai/contract/send | 계약서 발송 |
GET | /ai/contract/campaign/{collabNo} | 캠페인별 계약서 목록 조회 |
GET | /ai/contract/{contractId}/audit | 감사 추적 조회 |
| 메서드 | 경로 | 설명 |
|---|
GET | /ai/contract/{contractId} | 계약서 상세 조회 |
PUT | /ai/contract/{contractId}/creator-info | 크리에이터 정보 입력 |
POST | /ai/contract/{contractId}/otp/send | OTP 발송 요청 |
POST | /ai/contract/{contractId}/otp/verify | OTP 검증 |
POST | /ai/contract/{contractId}/sign | 서명 제출 |
| 메서드 | 경로 | 설명 |
|---|
PUT | /ai/contract/{contractId}/documents?type={type} | 서류 업로드/수정 (Upsert) |
GET | /ai/contract/{contractId}/documents | 첨부 서류 목록 조회 |
| 메서드 | 경로 | 설명 |
|---|
GET | /ai/contract/signature | 저장된 서명 조회 |
POST | /ai/contract/signature | 서명 저장 |
- 모든 API는 JWT Bearer 토큰 인증이 필요합니다.
- 관리자 API는 관리자 권한이 필요합니다.
- 크리에이터 API는 계약서 소유자만 접근 가능합니다.
- 모든 액션은 감사 로그에 기록됩니다 (IP, User-Agent 포함).