API

재직증명서 업로드

작성일 2026.03.23 | 수정일 2026.03.23

POST/employment-certificate/upload

재직증명서를 업로드하고 정보를 자동 추출합니다.

주민등록번호 등 개인정보가 포함된 경우 자동으로 마스킹 처리됩니다.
원본 파일은 별도로 S3에 안전하게 보관됩니다.
PDF 파일도 지원되며, 마스킹이 필요한 경우 자동으로 이미지로 변환 후 처리됩니다.

Body Params

Name	Type	Required	Description
file	String	*	base64로 인코딩된 파일 데이터
name	String		파일명 (미입력 시 자동 생성, 예: employment_certificate_1710936000000.jpeg)
contentType	String		파일 MIME 타입 (미입력 시 image/jpeg로 설정, 예: image/png, application/pdf)

Response

Name	Type	Required	Description
fileId	String	*	업로드된 파일 ID (재직자 추가 시 사용)
fileUrl	String	*	업로드된 파일 URL (마스킹 처리된 파일)
originalFileUrl	String	*	원본 파일 S3 URL
employmentInfo	Object	*	AI가 재직증명서에서 추출한 재직 정보
privacyMasking	Object	*	개인정보 마스킹 처리 정보
needsMasking	Boolean	*	마스킹 필요 여부

Structure

Request

{
  "file": "/9j/4AAQSkZJRgABAQEASABIAAD...(base64 인코딩된 이미지 데이터)",
  "name": "재직증명서.jpg",
  "contentType": "image/jpeg"
}

Response

{
  "fileId": "FL01abcdefghij",
  "fileUrl": "https://storage.solapi.com/documents/masked_재직증명서.jpeg",
  "originalFileUrl": "https://s3.ap-northeast-2.amazonaws.com/bucket/employment/original.jpg",
  "employmentInfo": {
    "companyName": "(주)솔라피",
    "employeeName": "김철수",
    "position": "과장",
    "department": "개발팀"
  },
  "privacyMasking": {
    "needsMasking": true
  }
}