DOCSCAN으로 앱에 ID 문서 스캔 기능 추가하기 - SDK 불필요

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

- 백엔드 개발자: SDK 없이 REST API를 통한 ID 스캔 기능 구현이 필요한 분

- 난이도: 중간 (HTTPS 요청 가능 언어 기반, JSON 파싱 기초 지식 요건)

핵심 요약

• SDK-Free REST API: DOCSCAN은 HTTPS 요청만으로 작동하며, 언어/프레임워크 제약 없음
• 글로벌 ID 지원: 200+ 국가의 11,000개 이상의 공식 ID 문서 유형 지원 (여권, 운전 면허 등)
• 자동 필드 추출: fullName, dateOfBirth, documentNumber 등 구조화된 데이터 추출
• 빠른 JSON 응답: 평균 처리 시간 5초 미만

섹션별 세부 요약

1. DOCSCAN 개요

• REST API 기반: PixLab Vision Platform에서 제공하는 고성능 문서 스캔 API
• 지원 문서 유형: 여권(MRZ/비-MRZ), 국가 ID, 운전 면허, 주민등록증 등
• 보안 처리: 문서는 RAM에서 처리되며, AWS S3 연결 시만 저장 가능

2. 주요 기능

• 자동 얼굴 자르기: ID 이미지에서 사용자 얼굴 자동 추출 (face_url 제공)
• MRZ 텍스트 추출: 기계독해 영역 (mrz_raw_text)의 텍스트 블록 제공
• 글로벌 커버리지: 200+ 국가의 공식 ID 문서 형식 지원

3. API 사용 예시

• GET 요청: 공개 이미지 URL 기반 스캔

```python

requests.get(params={'img': 'URL', 'type': 'passport', 'key': 'API_KEY'})

```

• POST 요청: 로컬 파일 업로드

```python

requests.post(files={'file': open('local_passport.png', 'rb')}, data={'type': 'passport', 'key': 'API_KEY'})

```

4. 응답 구조

• status: HTTP 상태 코드 (200 성공, error 필드 포함 실패 시)
• fields: fullName, dateOfBirth, nationality 등 구조화된 데이터
• face_url: 자동 자른 얼굴 이미지 URL
• mrz_raw_text: 기계독해 영역 텍스트

결론

• 실무 적용 팁: SDK 없이 Python, Node.js 등 모든 언어에서 HTTPS 요청으로 바로 사용 가능
• 추천사항: AWS S3 연동 시 문서 저장 가능, fintech 또는 KYC 시스템에서 효과적 활용 가능