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

개발 가이드

개요

한컴 통합문서뷰어

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

한컴 통합문서뷰어 예제

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

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

한컴 계정

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

한컴 OCR

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

한컴싸인

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

한글 오토메이션

### __이해하기__
이 문서는 한컴 OAuth 로그인 및 개발가이드 내용을 소개합니다.

 

---

### __로그인__
한컴 로그인은 아이디, 패스워드 없이 한글과컴퓨터 서비스 아이디로 간편하게 로그인하는 서비스입니다. 사용자는 번거로운 회원가입 절차 없이 서비스를 빠르게 이용할 수 있고, 서비스 사업자는 회원가입과 로그인에 대한 절차를 간소화하여 회원 수를 빠르게 증대할 수 있습니다. 
한컴 로그인 과정을 표현하면 다음과 같습니다.
![로그인{{w:800px, h:560px}}{{priority}}](/images/hancomaccount/login.png)

---

### __1. API 기본 정보__
 한컴 서비스 로그인 API는 GET, POST, DELETE 메소드를 이용해 호출할 수 있습니다.
 |메서드|인증|요청URL|응답 포맷|설명|
 |:----:|:----:|--------|:--------------:|-------------------|
 |GET|OAuth2.0|https&#65279;://accounts.hancom.com/oauth2/authorize|URL 리다이렉트|한컴 로그인 인증 요청|
 |POST|OAuth2.0|https&#65279;://api.hancom.com/accounts/oauth2/token|json|접근 토큰 발급 / 갱신 요청|
 |GET|OAuth2.0|https&#65279;://api.hancom.com/accounts/oauth2/me|json|한글과컴퓨터 서비스 이용자 정보 요청|
 |DELETE|OAuth2.0|https&#65279;://api.hancom.com/accounts/oauth2/conn-service-user|json|한글과컴퓨터 서비스 이용자 애플리케이션 연결 해제|

 

---

### __2. 요청 변수__
&nbsp;&nbsp;&nbsp;__2.1 한컴 로그인 인증 요청__ 
|요청 변수명|타입|필수 여부|기본값|설명|비고|
|:------------:|:-------:|:-----:|:-----:|----------------------------------------------|-----|
|response_type|string|Y|"code"|인증 과정에 대한 구분값|"code"값만 지원|
|client_id|string|Y|-|애플리케이션 등록 시 발급받은 Client ID 값|-|
|redirect_uri|string|Y|-|애플리케이션 등록 시 입력한 Callback URL 값|URL 인코딩 적용 후 전달|
|state|string|Y|-|사이트 간 요청 위조(cross-site request forgery) 공격 방지를 위해 애플리케이션에서 생성한 상태 토큰 값|URL 인코딩 적용 후 전달|
|scope|string|N|-|접근 허용 범위 처리를 위한 구분값|-|

인증 요청 예시(URL string)
```js
 "https://accounts.hancom.com/oauth2/authorize?response_type=code&client_id=jyvqxEyeaVyoremV&redirect_uri=http%3A%2F%2Ftest.exmaple.com%2redirect&state=hLiDdl2uhPtsftcu";
```
인증 요청 결과(URL string)
```js
 "https://CallbackURL?code={code값}&state={state값}";
```
&nbsp;&nbsp;&nbsp;__2.2 접근 토큰 발급 요청__ 
|요청 변수명|타입|필수 여부|기본값|설명|비고|
|:----------:|:-----:|:---------:|:---:|--------------------|---------------|
| grant_type | string | Y | - | 인증 과정에 대한 구분값 | 발급 : "authorization_code" / 갱신 : "refresh_token" |
| client_id | string | Y | - | 애플리케이션 등록 시 발급받은 Client ID 값 | - |
| client_secret | string | Y | - | 애플리케이션 등록 시 발급받은 Client Secret 값 | - |
| code | string | 발급 시 필수 | - | 로그인 성공, 인가허용상태 승인 완료 시 반환된 인증 코드 값 | - |
| redirect_uri | string | Y | - | 애플리케이션 등록 시 입력한 Callback URL 값 | URL 인코딩 적용 후 전달 |
| refresh_token | string | N | - | access_token 갱신 시 사용하는 값 | grant_type이 refresh_token 일 경우, 전달받은 refresh_token 값 사용 |

접근 토큰 발급 요청 예시(Javascript)
```js
const params = new URLSearchParams();
params.append("client_id", YOUR_CLIENT_ID);
params.append("client_secret", YOUR_CLIENT_SECRET);
params.append("code", YOUR_CODE);
params.append("grant_type", "authorization_code");
params.append("redirect_uri", "YOUR_CALLBACK_URL");

axios.post("https://api.hancom.com/accounts/oauth2/token", params);
```
접근 토큰 발급 요청 결과(JSON)
```json
{
 "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNCIsInNjb3BlIjpbInRoaXJkUmVzb3VyY2U6d3JpdGUiXSwiZXhwIjoxNjAwNzA5NDI5LCJlbWFpbCI6InNhbXBsZUBhYmMuY29tIiwiYXV0aG9yaXRpZXMiOlsiUk9MRV9VU0VSIl0sImp0aSI6IjNiM2U1NjlhLWRjNzktNDRmOC1iMDMzLTA2MjY4NjlkZDFhOSIsImNsaWVudF9pZCI6InRoaXJkLXBhcnR5LWFwcCJ9.QAU3sNuQjfgjB8SdQSWVFo4SClNmObwCsZiKKovOJxHUqvAyQZvrP6qDBLNUzInK8ljGCMuNSWAnV7mo6SALEvsMxcUD_YFHrtBC_o4EkXP3ouu3PLFLXcS5F_4uNZK3W74M24mNxglxzgnmFxfB63nh09vesZhSvqz1hXP8p3XQnGxYbeB7KAoP-DXaotwkPII2Wz9yAHjtWQ0cA-sSxN4ZFvTDYizKnMpu6T7NsWHhGdYdShn6BoT0PPC0pyfsvEiXWv9rRYLJVTOfFFIEfEUmo2kmYLUF9Y5_2gqkUiSR3oUZ1XNBeBvbVcrTdmkgnHy3FGvzYG6qndzuX3pQQA",
 "token_type": "bearer",
 "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxNCIsInNjb3BlIjpbInRoaXJkUmVzb3VyY2U6d3JpdGUiXSwiYXRpIjoiM2IzZTU2OWEtZGM3OS00NGY4LWIwMzMtMDYyNjg2OWRkMWE5IiwiZXhwIjoxNjAzMjY1NDI5LCJlbWFpbCI6InNhbXBsZUBhYmMuY29tIiwiYXV0aG9yaXRpZXMiOlsiUk9MRV9VU0VSIl0sImp0aSI6IjljMjMzZjBkLWNlMTYtNDVkYy04YzBmLWEyNzJlOGY1ZjA2OSIsImNsaWVudF9pZCI6InRoaXJkLXBhcnR5LWFwcCJ9.QjY0KlT4OYQxNycXSEEDLP0a_AAtNQuu0mpVpnw7AitXemukyv9Fm3jrtNFiUSPS6EeL7Jyi9PN6Xuo2cyNXT4do6xCmn3WJTcghaHgjqWZby-qLcX35F_AREO8vSbV40wXf5pLfMyuKSeUnArNiHf_DTyHmGJmrVe3ClQlAPDYbOI88mFxQ13_-7SdOCNPtd64uwrWWoPTsgdTz8LETfhnXD5MB0jfb7q0GfkNyAk4JZ3WBo7Wlj09dfvZjSBaDG8wIdjRv6tMdz51kQBnqe-9gxrcg_Xq1VkY9cNUMYgObe1Oakwa2Rz6GkFjA_HDZOuMMOknL2PqnhobzkNK5-g",
 "expires_in": "3600",
 "scope": "thirdResource:write",
 "jti": "3b3e569a-dc79-44f8-b033-0626869dd1a9"
}
```

&nbsp;&nbsp;&nbsp;__2.3 한글과컴퓨터 서비스 이용자 정보 요청__ 
|요청 헤더명|설명|비고|
|:-------:|----------------------------|--------|
|Authorization|접근 토큰(access token)을 전달하는 헤더 다음과 같은 형식으로 헤더 값에 접근 토큰(access token)을 포함 Authorization: [토큰 타입] [접근 토큰]|토큰 타입은 "Bearer"로 값이 고정|

한글과컴퓨터 서비스 이용자 정보 요청 예시
```js
axios.get("https://api.hancom.com/accounts/oauth2/me", null, {
 headers: {
 Authorization: `Bearer {로그인 인증 후 받은 접근 토큰 값}`,
 },
});
```

&nbsp;&nbsp;&nbsp;__2.4 한글과컴퓨터 서비스 이용자 애플리케이션 연결 해제 요청__ 
|요청 헤더명|설명|비고|
|:-------:|----------------------------|--------|
|Authorization|접근 토큰(access token)을 전달하는 헤더 다음과 같은 형식으로 헤더 값에 접근 토큰(access token)을 포함 Authorization: [토큰 타입] [접근 토큰]|토큰 타입은 "Bearer"로 값이 고정|

<style>
.foo table th:first-of-type {
 width: 15%;
}
 .foo table th:nth-of-type(2) {
 width: 10%;
}
.foo table th:nth-of-type(3) {
 width: 15%;
}
.foo table th:nth-of-type(4) {
 width: 10%;
}
.foo table th:nth-of-type(5) {
 width: 55%;
}
.foo table th:nth-of-type(6) {
 width: 10%;
}
</style>

<div class="foo">

|요청 변수명|타입|필수 여부|기본값|설명|비고|
|:----------:|:-----:|:---------:|:---:|--------------------|:---------------:|
| client_id | string | Y | - | 연결 해제 애플리케이션 Client ID | - |

</div>

한글과컴퓨터 서비스 이용자 정보 요청 예시
```js
const urlParam = new URLSearchParams();
urlParam.append("client_id", YOUR_CLIENT_ID);

axios.delete("https://api.hancom.com/accounts/oauth2/conn-service-user", {
 headers: {
 Authorization: `Bearer {로그인 인증 후 받은 접근 토큰 값}`,
 },
 params: urlParam
}
```

 

---

### __3. 출력 결과__
&nbsp;&nbsp;&nbsp;__3.1 한컴 로그인 인증 요청__ 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;로그인 인증 요청 API가 호출되면 사용자 로그인 화면으로 이동합니다. 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;로그인 및 정보 제공 동의 여부에 따라 Callback URL과 데이터가 문자열로 전송됩니다. 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;__3.1.1 로그인 성공 여부에 따른 응답 예시__ 
|케이스|응답 예시|
|:-------:|--------------------|
|API요청 성공 시|https&#65279;://CallbackURL?code={코드값}&state={상태값}|
|API요청 실패 시|https&#65279;://CallbackURL?error={오류코드}&error_description={오류메시지}&state={상태값}|

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;__3.1.2 파라미터 설명__ 
|필드|타입|설명|
|:------:|:------:|------------------------------------------------------|
|code|string|한컴 로그인 인증 성공 시 반환되는 인증 코드로, 접근 토큰(access_token)과 갱신 토큰(refresh_token) 발급을 위해 사용|
|state|string| 사이트 간 요청 위조(cross-site request forgery) 공격 방지를 위해 애플리케이션에서 생성한 상태 토큰에 URL 인코딩이 적용된 값 |
|error|string| 한컴 로그인 인증 실패 시 반환되는 오류 코드 |
|error_description|string| 한컴 로그인 인증 실패 시 반환되는 오류 메시지 |

&nbsp;&nbsp;&nbsp;__3.2 접근 토큰 발급 요청__ 
|필드|타입|설명|
|:--------:|:-----:|-------------------------------------|
| access_token | string | 접근 토큰으로, 발급 후 expires_in 파라미터 설정값(초) 경과 시 만료 |
| refresh_token | string | 갱신 토큰으로, 접근 토큰 만료 시 접근 토큰 재발급에 사용 |
| token_type | string | 접근 토큰의 타입으로 Bearer를 지원 |
| expires_in | integer | 접근 토큰의 유효시간(초) |
| scope | string | 접근 허용 범위 |
| jti | string | JWT(JSON Web Token)의 고유 식별자 (ID) |
| error | string | 오류 코드 |
| error_description | string | 오류 메시지 |

&nbsp;&nbsp;&nbsp;__3.3 한글과컴퓨터 서비스 이용자 정보 요청__ 
|필드|타입|설명|
|:------:|:------:|-------------------|
| email | string | 사용자 이메일 |
| identify | integer | 사용자 식별 정보 |
| state | string | 로그인한 사용자의 활성 여부 |

 

---

### __4. 오류 코드__
| HTTP 코드 | 오류 코드 | 오류 메시지 | 조치 방안 |
|:-----:|:-------:|---------------------|---------------------------------------------|
| 400 | - | format error | 파라미터가 지나치게 길거나 누락되었거나 잘못된 값이거나 등 형식 오류가 있습니다. 형식에 맞춰 올바른 값으로 수정합니다. |
| 404 | HOSE401 | NOT_FOUND_RESOURCE / Client Id를 찾을 수 없습니다. | 올바른 Client ID를 복사했는지 확인합니다. Client ID가 유효하지 않은 경우 재발급 받습니다. |
| 404 | HOSE402 | NOT_FOUND_RESOURCE / RedirectUri가 올바르지 않습니다. | 형식에 맞춰 유효한 Redirect URI를 입력합니다. |
| 404 | HOSE403 | NOT_FOUND_RESOURCE / ResponseType이 올바르지 않습니다. | 응답 형식에 맞춰 유효한 코드 값을 입력합니다. |
| 500 | -	| internal server error | 내부 서버에서 일시적으로 발생한 오류이므로 다음에 다시 시도합니다. |

한컴 OAuth 로그인 

URI의 구성

변환 쌍 및 모듈명과 변환 API

매개 변수

응답 형식

응답 코드

문서 변환 API

file_path

ext_to

error code

HTML 문서 뷰어 API

릴리즈 노트

docsconverter

공통 가이드 

디자인 리소스 

hancomaccount

URL의 구성

API 엔드포인트

에러 처리

제품 유지 보수

hancomocr

Webhook

hancomsign-api

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

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

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

Properties

Methods

Action

CtrlCode

ParameterSet

ParameterArray

HwpCtrl

webhwp

한컴디벨로퍼

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

웹한글 기안기

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

PDF 다운로드

웹한글 기안기 예제