OCR API 주소지 추출 기능은 신분증에 기재된 주소지를 읽고 추출하는 기능입니다. 해당 API는 주민등록증, 운전면허증에만 사용이 가능하며, 신분증의 주요 정보 OCR 추출 기능이 기본적으로 탑재되어 있습니다.


1️⃣ 주소지 OCR API

<aside> 💡 https://tmp.useb.co.kr/ocr/address (개발계)

운영계 API는 계약 후 제공해드립니다.

</aside>

2️⃣ OAuth 인증

<aside> 💡 OAuth 2.0 JWT 발급 및 개발가이드

세일즈팀을 통해서 발급 받은 계정 정보를 활용해서 Json Web Token을 생성하는 방법을 참고하시기 바랍니다.

</aside>

3️⃣ Header

Field Description
Content-Type application/json, multipart/form-data
Authorization Bearer token

4️⃣ Request Body Field

Field Type Description
image_base64 [optional] String 주민등록증사진 예) 이미지 base64코드
image [optional] File 주민등록증사진 예) jpg, png
mask_mode [optional] Boolean 마스킹 처리된 이미지 리턴 여부 예) true, false

5️⃣ Response (Success 200)

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

6️⃣ Error Code

Untitled

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)