다양한 유형의 파일을 원하는 형식으로 변환하는 솔루션입니다. 신속하고 편리하게 높은 품질의 문서 변환 서비스를 만들어 보세요.

개발 가이드

개요

한컴 통합문서뷰어

한컴 통합문서뷰어의 API를 직접 호출하여 결과를 확인해 보세요.

한컴 통합문서뷰어 예제

개발자와 의견을 나누고 문제를 해결하거나 제품을 구매하여 활용해 보세요!

한컴 로그인은 한글과컴퓨터 서비스에서 제공하는 OAuth2.0 기반의 간편 로그인 기능입니다.

한컴 계정

한컴 OCR은 이미지나 PDF 파일에 포함된 글자를 추출하는 솔루션입니다. 다양한 유형의 문서와 이미지에서 텍스트를 인식하고 추출하는 기능을 제공합니다.

한컴 OCR

한컴싸인에서 제공하는 Webhook/API 사용 방법에 대한 가이드입니다. Webhook/API를 통해 한컴싸인을 쉽고 빠르게 연동하여 사용할 수 있습니다.

한컴싸인

OLE Automation을 통해 한글 프로그램을 자동화하는 방법에 대한 가이드입니다. 외부 클라이언트에서 OLE(COM) Object를 이용하여 한글 기능을 실행하거나 문서를 제어할 수 있습니다.

한글 오토메이션

한컴 통합문서뷰어는 JSON 형식의 반환을 요청하는 (show_type=2) 변환 API를 정상적으로
수신한 경우 다음과 같은 내용을 JSON 형식으로 구성하여 변환 결과를 반환합니다.

|<div style="width:250px">필드</div>|<div style="width:100px">형식</div>|설명|비고|
|--|--|--|--|
|{||||
|&nbsp;&nbsp;"docsconverter": {||||
|&nbsp;&nbsp;&nbsp;&nbsp;"result": {||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"code": "응답_코드",|문자열| 응답 코드 참조||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"message": "응답_메시지"|문자열|응답 코드 참조||
|&nbsp;&nbsp;&nbsp;&nbsp;},||||
|&nbsp;&nbsp;&nbsp;&nbsp;"file": {|||응답 코드가 "0000"인 경우에만 표시|
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"key": "변환_요청_고유번호",|문자열|비동기 변환 시 요청을 확인하기 위한 문자열을 반환합니다.||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status": "변환_상태_코드",|문자열|I: 변환 준비 중<br>P: 변환 실행 중<br>D: 변환 완료<br>F: 변환 실패||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"total_page": 페이지_수,|숫자|전체 페이지 수를 표시합니다.||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"process_page": 페이지_번호,|숫자|비동기 변환 시 현재 변환 중인 페이지 번호를 표시합니다.|status가 "P"(변환 실행 중)일 때 값이 표시되며, "D"(변환 완료) 또는 "F"(변환 실패)일 경우 0으로 변경됨|
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"target_file": "결과_파일_경로",|문자열|변환 결과가 하나의 파일(예: PDF)인 경우 해당하는 경로를 표시합니다.||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"resource_file": [|문자열<br>배열|변환 결과가 여러 개의 파일(예: JPG)인 경우 해당하는 경로를 표시합니다.||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"첫 번째_변환_결과_파일_경로",||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"두 번째_변환_결과_파일_경로",||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;...||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"마지막_변환_결과_파일_경로",||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"sheet_info": [|배열|시트 정보를 표시합니다.|스프레드시트 모듈(cell)인 경우에만 표시|
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"t": 시트_이름,|문자열|시트 이름을 표시합니다.||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"r": 행_조각_수,|숫자|해당 시트를 구성하는 그림 블록의 행 조각 수를 표시합니다.|split_height 옵션을 적용하지 않은 경우 1 반환|
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"c": 열_조각_수|숫자|해당 시트를 구성하는 그림 블록의 열 조각 수를 표시합니다.|split_width 옵션을 적용하지 않은 경우 1 반환|
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;...||||
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;]||||
|&nbsp;&nbsp;&nbsp;&nbsp;}||||
|&nbsp;&nbsp;}||||
|}||||

응답 형식

URI의 구성

변환 쌍 및 모듈명과 변환 API

매개 변수

응답 코드

문서 변환 API

file_path

ext_to

error code

HTML 문서 뷰어 API

릴리즈 노트

docsconverter

공통 가이드 

한컴 OAuth 로그인 

디자인 리소스 

hancomaccount

URL의 구성

API 엔드포인트

에러 처리

제품 유지 보수

hancomocr

Webhook

hancomsign-api

구성/구조/지원되는 파일 형식

한글 컨트롤(ActiveX 기반) 대비 API 변경 사항

웹한글 기안기 API 기본 사용법

Properties

Methods

Action

CtrlCode

ParameterSet

ParameterArray

HwpCtrl

webhwp

한컴디벨로퍼

데스크톱에 한컴오피스 한글을 설치하지 않아도 웹 브라우저에 접속하여 한글 프로그램을 사용할 수 있습니다. 전자 결재를 상신하거나 양식 문서 또는 각종 보고서를 작성하는 시스템과 연동하여 활용해 보세요.

웹한글 기안기

웹한글 기안기의 API 예제를 직접 작성하여 결과를 확인해 보세요. 활용 가능한 API 정보는 문서 > 개발 가이드 →를 통해 확인할 수 있습니다.

PDF 다운로드

웹한글 기안기 예제