CLOVA OCR 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

CLOVA OCR(Optical Character Recognition)은 전송한 문서나 이미지를 인식하여 사용자가 지정한 영역의 텍스트와 데이터를 정확하게 추출하는 네이버 클라우드 플랫폼의 서비스입니다. 이미지의 모든 텍스트 인식, 도메인에 배포된 템플릿이 포함된 이미지의 텍스트 인식, 템플릿 내에서 필요한 글자만 빠르게 추출하는 기능에 대한 API를 RESTful 형태로 제공합니다.

CLOVA OCR 공통 설정

CLOVA OCR API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

CLOVA OCR 빌더에서 생성된 API Gateway의 고유 Invoke URL
참고

Invoke URL을 확인하는 방법은 CLOVA OCR 사용 가이드를 참조해 주십시오.

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
X-OCR-SECRET Required 네이버 클라우드 플랫폼 도메인(Domain)에서 API Gateway 연동 시 생성한 Client Secret
Content-Type Required 요청 데이터의 형식
  • application/json | multipart/form-data

응답

공통 응답 형식을 설명합니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 0001 URL is invalid. 입력한 호출 URL이 유효하지 않음
  • 호출한 POST URL이 정확한지 확인
401 0002 Secret key validate failed. 입력한 Secret Key가 검증되지 않음
  • X-OCR-SECRET:{Client Secret} 값이 정확한지 확인
400 0011 Request body invalid. 입력한 요청 바디 값이 올바르지 않음
400 0021 Protocol version not support. API 버전이 지원되지 않음
400 0022 Request domain invalid. 입력한 요청 도메인 값이 올바르지 않음
400 0023 API request count reach the upper limit. API 호출 제한에 도달함
400 0025 Calls to this api have exceeded the rate limit. API 호출 수가 요금 제한(Rate Limit)을 초과함
400 0028 Table detection disabled: Please activate the table extractor button. 표 추출 여부 OFF 상태에서 enableTableDetection: true로 호출함
500 0500 Unknown service error. 알 수 없는 서비스 오류가 발생함
500 0501 OCR service error. OCR 서비스 오류가 발생함
500 1021 Not found deploy information. Please confirm the template is released. Template 배포 이력을 찾을 수 없음
  • 네이버 클라우드 플랫폼 콘솔의 도메인에 템플릿 배포 여부 확인 필요
500 1022 Service is blocked. 서비스 일시 정지
참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

CLOVA OCR API

CLOVA OCR 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
General OCR 일반 텍스트 및 표 추출 OCR
Template OCR Template OCR
Document OCR > 명함 명함 정보 OCR
Document OCR > 신용카드 신용카드 정보 OCR
Document OCR > 신분증 > 여권 여권 정보 OCR
Document OCR > 신분증 > 외국인등록증 외국인등록증 정보 OCR
Document OCR > 신분증 > 운전면허증 운전면허증 정보 OCR
Document OCR > 신분증 > 주민등록증 주민등록증 정보 OCR

CLOVA OCR 연관 리소스

CLOVA OCR API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.