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

개발 가이드

개요

한컴 통합문서뷰어

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

한컴 통합문서뷰어 예제

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

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

한컴 계정

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

한컴 OCR

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

한컴싸인

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

한글 오토메이션

### 한컴싸인의 웹훅(Webhook) 기능
* 한컴싸인에서 특정 이벤트가 발생 했을 때 해당 이벤트 정보를 등록한 서비스(URL)로 전달해주는 기능 입니다.
* 전달 방식은 https 프로토콜을 통한 POST 방식으로 json data를 넘겨줍니다.

### 웹훅(Webhook) 등록 및 관리할 수 있는 권한
* 웹훅 등록은 한컴싸인의 관리자 권한이 있어야지만 가능 합니다.
* 관리자 권한을 가진 사용자는 한컴싸인에 로그인 후 생성된 조직 페이지에서 등록이 가능 합니다.

### 웹훅(Webhook) 등록 절차
* 한컴싸인의 관리자 권한이 있는 사용자는 한컴싸인에 로그인 후 설정 -> 조직(Tab) 으로 이동해 `추가` 버튼을 눌러 웹훅을 등록 할 수 있습니다.
![웹훅초기페이지{{w:941px, h:561px}}{{priority}}](/images/hancomsign-api/webhook1.png)
* 웹훅 등록시에는 URL은 필수 값이며 `https` 프로토콜만 입력이 가능 합니다.
* 이벤트는 기본적으로 모두 등록 할 수 있게 `체크` 되어 있는 상태이며, 필요시 선택하여 등록 할 수 있습니다.
![웹훅등록페이지{{w:939px, h:579px}}](/images/hancomsign-api/webhook2.png)
* 웹훅 등록 완료 후 보기 화면으로 이동되며 우측 상단의 버튼을 눌러 `새로고침` 이나 `편집` 화면으로 들어 갈 수 있습니다.
![웹훅등록{{w:927px, h:565px}}](/images/hancomsign-api/webhook3.png)
* 웹훅 편집 화면으로 들어가면, 기존 정보를 편집하거나 우측 상단의 `초기화` 버튼을 눌러 웹훅 정보를 처음과 같이 초기화 시킬 수 있습니다.
![웹훅등록{{w:925px, h:558px}}](/images/hancomsign-api/webhook4.png)

### 웹훅(Webhook) 동작(이벤트) 목록

| 이벤트 이름(event_name) | 이벤트 키(event_key) | 설명(description) |
|---|---|---|
| 서명 문서 임시 저장 | sign_task_temp_saved | 서명 문서를 임시 저장 후 발생 * 서명 문서를 `임시저장`, 또는 `저장` 시에 이벤트가 발생된다. |
| 서명 문서 발송 완료 | sign_task_sent | 서명자(들)에게 문서 발송 완료 후 발생 * 서명자가 여러명일 경우 해당 서명자들의 수 만큼 이벤트가 발생된다. |
| 서명 참여자 변경 | sign_party_changed | 서명 문서 참여자를 변경 후 발생 * 변경된 서명자에 대한 서명 요청 이벤트가 전송 되고 * 변경된 서명자의 서명자 변경 이벤트가 전송이 된다. |
| 서명 문서 거부 | sign_task_denied | 서명 문서 거부 후 발생 * 서명 거부 후 이벤트가 발생 된다. |
| 서명 완료 | sign_task_completed | 서명 문서를 모두 서명 완료 후 발생 * 단일 서명일 경우 최종 서명 완료 후 서명자 수 만큼의 이벤트가 발생된다. * 배치 서명의 경우 각각의 서명자가 서명 완료 후 서명 이벤트가 발생된다. |
| 서명 문서 삭제 | sign_task_deleted | 서명 문서를 삭제한 후 발생 * 서명 문서가 삭제된 후 이벤트가 발생된다. |


### 웹훅(Webhook)이 등록된 서비스에 요청하는 json data 전체 구조
| Property Name | Value | Required | Description |
|---|---|:---:|---|
| webhook_id | Integer | O | 웹훅 아이디 |
| owner_email | String | O | 서명 문서 작성자 이메일 |
| user_email | String | O | 사용자 이메일 * 임시 저장시에는 저장한 사람 이메일 * 서명 발송시에는 서명할 사람 이메일 * 서명 완료시에는 완료한 사람 이메일 * 서명 삭제시에는 삭제한 사람 이메일 * 서명 거부시에는 거부한 사람 이메일 * 서명 사용자 변경시에는 변경한 사람 이메일 |
| event_key | String | O | 이벤트 키 |
| event_name | String | O | 이벤트 이름 |
| event_company | String | O | 이벤트 서비스 회사 |
| event_url | String | O | 이벤트 주소 |
| document_info.doc_name | String | O | 서명 문서 이름 |
| document_info.create_date | Integer | O | 서명 문서 생성일 |
| document_info.complete_date | Integer | O | 서명 문서 완료일 |
| sign_party_info.before_signer_name | String | X | 이전 서명자 이름 |
| sign_party_info.before_signer_email | String | X | 이전 서명자 이메일 |
| sign_party_info.new_signer_name | String | X | 새로운 서명자 이름 |
| sign_party_info.new_signer_email | String | X | 새로운 서명자 이메일 |

### 웹훅(Webhook)이 등록된 이벤트별 json data 예시
#### 1. 서명 문서 임시 저장
```json
{
 webhook_id: {DB에 등록된 웹훅 순차 아이디},
 owner_email: "{서명 요청자 이메일}",
 user_email: "{저장한 사용자 이메일}",
 event_key: "sign_task_temp_saved",
 event_name: "서명 문서 임시 저장",
 event_company: "{이벤트 서비스 등록 회사명}",
 document_info: {
 doc_name: "{서명 문서 이름}",
 created_date: {서명 문서 생성일},
 completed_date: {서명 문서 완료일},
 }
}
```
#### 2. 서명 문서 발송 완료
```json
{
 webhook_id: {DB에 등록된 웹훅 순차 아이디},
 owner_email: "{서명 요청자 이메일}",
 user_email: "{서명할 사용자 이메일}",
 event_key: "sign_task_sent",
 event_name: "서명 문서 발송 완료",
 event_company: "{이벤트 서비스 등록 회사명}",
 document_info: {
 doc_name: "{서명 문서 이름}",
 created_date: {서명 문서 생성일},
 completed_date: {서명 문서 완료일},
 }
}
```
#### 3. 서명 참여자 변경
```json
{
 webhook_id: {DB에 등록된 웹훅 순차 아이디},
 owner_email: "{서명 요청자 이메일}",
 user_email: "{서명할 사용자 이메일}",
 event_key: "sign_party_changed",
 event_name: "서명 참여자 변경",
 event_company: "{이벤트 서비스 등록 회사명}",
 document_info: {
 doc_name: "{서명 문서 이름}",
 created_date: {서명 문서 생성일},
 completed_date: {서명 문서 완료일},
 },
 sign_party_info: {
 before_signer_name: "{이전 서명자 이름}",
 before_signer_email: "{이전 서명자 이메일}",
 new_signer_name: "{신규 서명자 이름}",
 new_signer_email: "{신규 서명자 이메일}"
 }
}
```
#### 4. 서명 문서 거부 
```json
{
 webhook_id: {DB에 등록된 웹훅 순차 아이디},
 owner_email: "{서명 요청자 이메일}",
 user_email: "{서명할 사용자 이메일}",
 event_key: "sign_task_denied",
 event_name: "서명 문서 거부",
 event_company: "{이벤트 서비스 등록 회사명}",
 document_info: {
 doc_name: "{서명 문서 이름}",
 created_date: {서명 문서 생성일},
 completed_date: {서명 문서 완료일},
 }
}
```
#### 5. 서명 완료
```json
{
 webhook_id: {DB에 등록된 웹훅 순차 아이디},
 owner_email: "{서명 요청자 이메일}",
 user_email: "{서명할 사용자 이메일}",
 event_key: "sign_task_completed",
 event_name: "서명 완료",
 event_company: "{이벤트 서비스 등록 회사명}",
 document_info: {
 doc_name: "{서명 문서 이름}",
 created_date: {서명 문서 생성일},
 completed_date: {서명 문서 완료일},
 }
}
```
#### 6. 서명 문서 삭제
```json
{
 webhook_id: {DB에 등록된 웹훅 순차 아이디},
 owner_email: "{서명 요청자 이메일}",
 user_email: "{서명할 사용자 이메일}",
 event_key: "sign_task_deleted",
 event_name: "서명 문서 삭제",
 event_company: "{이벤트 서비스 등록 회사명}",
 document_info: {
 doc_name: "{서명 문서 이름}",
 created_date: {서명 문서 생성일},
 completed_date: {서명 문서 완료일},
 }
}
```

Webhook

URI의 구성

변환 쌍 및 모듈명과 변환 API

매개 변수

응답 형식

응답 코드

문서 변환 API

file_path

ext_to

error code

HTML 문서 뷰어 API

릴리즈 노트

docsconverter

공통 가이드 

한컴 OAuth 로그인 

디자인 리소스 

hancomaccount

URL의 구성

API 엔드포인트

에러 처리

제품 유지 보수

hancomocr

hancomsign-api

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

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

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

Properties

Methods

Action

CtrlCode

ParameterSet

ParameterArray

HwpCtrl

webhwp

한컴디벨로퍼

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

웹한글 기안기

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

PDF 다운로드

웹한글 기안기 예제