translation (웹사이트 번역요청)
- 인쇄
- PDF
translation (웹사이트 번역요청)
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
개요
- 소스 언어로 작성된 html문서 혹은 element를 타깃 언어로 번역하는 API
- 번역 지원 언어쌍 : 한국어↔영어, 한국어↔일본어, 한국어↔중국어(간체)
- 소스 언어를 지정하지 않아도 Translation API에서 자동으로 언어를 감지하여 번역 결과를 제공. 이 경우, 언어 감지에 추가 과금은 하지 않고 번역 요청 글자 수 기준으로만 과금
Header
| Name | Description |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
| X-NCP-APIGW-API-KEY-ID | NCP 앱 등록 시 발급받은 Client ID |
| X-NCP-APIGW-API-KEY | NCP 앱 등록 시 발급받은 Secret Key |
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
| source | String{ko,ja,en,zh-CN} | true | - 소스 언어 코드 - auto로 설정 시 자동으로 소스 언어를 감지 |
| target | String{ko,ja,en,zh-CN} | true | 타깃 언어 코드 |
| html | String | true | - 번역할 html 문서 전체 또는 element - UTF-8 기준 태그, 공백 포함 20만 bytes 이내 요청 가능 |
Response
String 형식으로 리턴
| Field Name | Type | Description |
|---|---|---|
| status_code | Integer | 정상 응답 시 200 |
| data | String | 번역된 html string |
CURL Example
$ curl --location --request POST 'https://naveropenapi.apigw.ntruss.com/web-trans/v1/translate' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-NCP-APIGW-API-KEY-ID: 발급받은_CLIENT_ID' \
--header 'X-NCP-APIGW-API-KEY: 발급받은_SECRET_KEY' \
--data-urlencode 'source=ko' \
--data-urlencode 'target=en' \
--data-urlencode 'html=<div>안녕하세요. 파파고입니다.</div>'\''
<div papago-id="0" papago-translate="translated"><font class="papago-parent"><font class="papago-source" style="display:none;">
</font>
</font><font class="papago-parent"><font class="papago-source" style="display:none;"> 안녕하세요. 파파고입니다.</font> Hello, I'\''m Papago.</font><font class="papago-parent"><font class="papago-source" style="display:none;">
</font>
</font></div>%
'
<!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Example</title>
<style>
body {
margin-top: 50px;
}
ul.comment_container {
width: 500px;
list-style-type: none;
}
li.comment_item_wrapper {
margin-bottom: 5rem;
padding: 10px 20px;
border: 1px solid gray;
border-radius: 10px;
}
.user_info {
font-weight: bold;
}
</style>
</head>
<body>
<!-- comments -->
<ul class="comment_container">
<!-- comment -->
<li class="comment_item_wrapper">
<div class="user_info">
<span class="nickname">user1</span>
</div>
<div class="content">
<p>
Lorem ipsum dolor sit amet consectetur adipisicing elit. Natus
nostrum in earum minus voluptates nobis fugiat rerum totam illum
ipsum.
</p>
</div>
</li>
<!-- comment -->
<!-- comment -->
<li class="comment_item_wrapper">
<div class="user_info">
<span class="nickname">user2</span>
</div>
<div class="content">
<p>Lorem ipsum dolor sit amet.</p>
</div>
</li>
<!-- comment -->
<!-- comment -->
<li class="comment_item_wrapper">
<div class="user_info">
<span class="nickname">user3</span>
</div>
<div class="content">
<p>
Lorem ipsum dolor sit, amet consectetur adipisicing elit. Ex tempora
ipsa iusto temporibus consectetur. Libero sequi consequatur
quibusdam dignissimos totam, praesentium harum dolor nisi
repudiandae in error tempora incidunt aperiam.
</p>
</div>
</li>
<!-- comment -->
<!-- comment -->
<li class="comment_item_wrapper">
<div class="user_info">
<span class="nickname">user4</span>
</div>
<div class="content">
<p>
Lorem ipsum dolor sit amet consectetur adipisicing elit. Natus
nostrum in earum minus voluptates nobis fugiat rerum totam illum
ipsum.
</p>
<br />
<p>Lorem ipsum dolor sit amet.</p>
</div>
</li>
<!-- comment -->
</ul>
<!-- comments -->
<script>
const comments = [
...document.getElementsByClassName('comment_item_wrapper'),
];
const htmlsToRequest = comments.map((comment) => comment.outerHTML);
console.log(htmlsToRequest);
</script>
</body>
</html>이 문서가 도움이 되었습니까?