등록증 스캐너 (OCR)
이미지 처리 서비스 중신분증 및 사업자등록증의 정보를 정밀하게 판독하여 데이터화합니다.
API 키 필수
HTTPS
POST
/api/v1/ocr/idcard
API 설명
신분증(주민등록증, 운전면허증)과 사업자등록증의 텍스트 정보를 최첨단 비전 AI 모델을 통해 실시간으로 추출합니다. 얼굴 사진, 성명, 등록번호, 주소, 사업자 정보 등 핵심 데이터를 정형화된 JSON 포맷으로 제공하여 업무 자동화와 본인 확인 절차를 혁신적으로 개선할 수 있습니다.
사용 가이드
### 개요
신분증(주민등록증, 운전면허증) 및 사업자등록증 이미지를 분석하여 텍스트 정보를 데이터화합니다.
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| base64_image | String | Y | 분석할 이미지의 Base64 인코딩 문자열 (data-uri 포함 가능) |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | 분석 성공 여부 |
| info | Object | 추출된 정보 객체 |
| info.type | String | 증명서 종류 (주민등록증, 운전면허증, 사업자등록증) |
| info.name | String | 성명 또는 상호명 |
| info.id_number | String | 주민등록번호 또는 사업자등록번호 |
| info.representative | String | 대표자 성명 (사업자등록증인 경우) |
| info.address | String | 주소 또는 사업장 소재지 |
| info.issue_date | String | 발행일 또는 개업연월일 |
| info.biz_type | String | 업태 (사업자등록증인 경우) |
| info.biz_item | String | 종목 (사업자등록증인 경우) |
| raw_text | String | AI가 추출한 원문 텍스트 전체 |
| api | String | 호출된 API 식별값 (ocr-idcard) |
| remaining | Integer | 잔여 호출 횟수 |
### 응답 예시 (사업자등록증 인 경우)
```json
{
"success": true,
"info": {
"type": "사업자등록증",
"name": "(주)에이아이엔진",
"id_number": "123-45-67890",
"representative": "홍길동",
"address": "서울특별시 강남구 테헤란로 123",
"issue_date": "2024년 01월 01일",
"biz_type": "서비스",
"biz_item": "소프트웨어 개발"
},
"raw_text": "...",
"api": "ocr-idcard",
"remaining": 98
}
```
### 응답 예시 (주민등록증인 경우)
```json
{
"success": true,
"info": {
"type": "주민등록증",
"name": "김철수",
"id_number": "900101-1234567",
"representative": "",
"address": "서울특별시 중구 남산동 12-34",
"issue_date": "2023년 05월 20일",
"biz_type": "",
"biz_item": ""
},
"raw_text": "...",
"api": "ocr-idcard",
"remaining": 97
}
```
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/ocr/idcard \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"base64_image":"...IMAGE_BASE64_DATA..."}'