OCR API 주소지 추출 기능은 신분증에 기재된 주소지를 읽고 추출하는 기능입니다. 해당 API는 주민등록증, 운전면허증에만 사용이 가능하며, 신분증의 주요 정보 OCR 추출 기능이 기본적으로 탑재되어 있습니다.
<aside> 💡 https://tmp.useb.co.kr/ocr/address (개발계)
운영계 API는 계약 후 제공해드립니다.
</aside>
<aside> 💡 OAuth 2.0 JWT 발급 및 개발가이드
세일즈팀을 통해서 발급 받은 계정 정보를 활용해서 Json Web Token을 생성하는 방법을 참고하시기 바랍니다.
</aside>
Field | Description |
---|---|
Content-Type | application/json, multipart/form-data |
Authorization | Bearer token |
Field | Type | Description |
---|---|---|
image_base64 [optional] | String | 주민등록증사진 예) 이미지 base64코드 |
image [optional] | File | 주민등록증사진 예) jpg, png |
mask_mode [optional] | Boolean | 마스킹 처리된 이미지 리턴 여부 예) true, false |
{
"success": true,
"message": "정상적인 주민등록증입니다.",
"data": {
"idType": "1",
"userName": "홍길동",
"juminNo1": "880123",
"juminNo2": "1912345",
"_juminNo2": "1******",
"address": "인천광역시 계양구 박촌동 11 23 아트빌 101호",
"issueDate": "20110123"
},
"transaction_id": "f94b6cdf2abdbdb43b439869001724da"
}
{
"success": true,
"message": "정상적인 면허증입니다.",
"data": {
"idType": "2",
"userName": "홍길동",
"driverNo": "11-16-XXXXXX-60",
"juminNo1": "881212",
"juminNo2": "1012345",
"_juminNo2": "1******",
"address": "서울특별시 송파구 올림픽로 111 101동 101호 (신천동 파크리오)",
"issueDate": "20110108"
},
"transaction_id": "0eef8795bb7ef98acff85a278e92d1ae"
}
Name | Type | Description |
---|---|---|
O002 | file_format_invalid | 파일 형식이 올바르지 않은 경우(jpg, png가 아닌 경우) |
O003 | file_type_invalid | 다른 신분증을 시도한 경우, 빛반사나 사진 화질 문제로 신분증 핵심정보를 읽지 못한 경우 |
O004 | file_width_too_small | 가로 길이가 500px 이하일 때 (OCR 성능을 위해서 500~1000px 권장) |
O007 | empty_data | 이미지 없이 OCR API를 호출한 경우 |
O010 | partially_recognized | OCR 처리 결과 부분적으로 빠진 정보가 있는 경우(Http status code는 200 OK) |