API

재직증명서 업로드

작성일 2026.03.23 | 수정일 2026.03.23

POST/employment-certificate/upload

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

  • 주민등록번호 등 개인정보가 포함된 경우 자동으로 마스킹 처리됩니다.

  • 원본 파일은 별도로 S3에 안전하게 보관됩니다.

  • PDF 파일도 지원되며, 마스킹이 필요한 경우 자동으로 이미지로 변환 후 처리됩니다.

Body Params

NameTypeRequiredDescription
fileString*base64로 인코딩된 파일 데이터
nameString파일명 (미입력 시 자동 생성, 예: employment_certificate_1710936000000.jpeg)
contentTypeString파일 MIME 타입 (미입력 시 image/jpeg로 설정, 예: image/png, application/pdf)

Response

NameTypeRequiredDescription
fileIdString*업로드된 파일 ID (재직자 추가 시 사용)
fileUrlString*업로드된 파일 URL (마스킹 처리된 파일)
originalFileUrlString*원본 파일 S3 URL
employmentInfoObject*AI가 재직증명서에서 추출한 재직 정보
privacyMaskingObject*개인정보 마스킹 처리 정보
needsMaskingBoolean*마스킹 필요 여부

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 } }