CJKWord CAW API 고객 사용 안내서

서비스 주소

API 기본 주소: https://cjkword.com/api
JavaScript SDK: https://cjkword.com/api/sdk/js/caw-api-sdk.js
온라인 예제: https://cjkword.com/api/example/simple_editor.html
상태 확인: https://cjkword.com/api/v1/health.php

온라인 예제 API 상태 확인

JavaScript SDK 예제

<script src="https://cjkword.com/api/sdk/js/caw-api-sdk.js"></script>
<script>
  const client = new CawApiSDK.CawApiClient({
    apiBase: 'https://cjkword.com/api'
  });
  const engine = new CawApiSDK.CawInputEngine(client);

  await engine.inputKey('m');
  await engine.inputKey('a');
  console.log(engine.text); // 馬
</script>

직접 API 호출

단일 코드 변환

GET https://cjkword.com/api/v1/caw/plain-convert.php?code=ma

{
  "ok": true,
  "version": "2026.06.20",
  "code": "ma",
  "text": "馬",
  "type": "character"
}

키보드 조합 입력

POST https://cjkword.com/api/v1/caw/type-letter-hold.php
Content-Type: application/json

{
  "currentCode": "baf",
  "key": "e"
}

위 요청은 bafe 조합을 완성하고 半을 반환합니다.

조합 상태

`pending`	아직 코드를 더 입력해야 하는 상태
`commit`	새 한자 글자를 표시
`replace`	표시된 글자를 더 긴 조합 결과로 교체
`commit-next`	앞 조합을 끝내고 다음 글자를 시작
`finalized`	`v` 키로 현재 조합을 종료

보안 안내

상태 확인, 데이터 상태 확인, CAW 변환 API, 온라인 예제는 고객이 API/SDK 작동을 확인할 수 있도록 비밀번호 없이 공개해도 됩니다.

https://cjkword.com/api/v1/health.php
https://cjkword.com/api/v1/data-health.php
https://cjkword.com/api/v1/caw/plain-convert.php?code=ma
https://cjkword.com/api/example/simple_editor.html

업로드, 삭제, 데이터 재생성, 관리자용 빌드 실행처럼 서버 상태를 바꾸는 기능은 공개하지 않고 별도 인증 영역에 둡니다.

관리자 아이디와 비밀번호를 공개 JavaScript 코드에 직접 넣지 마십시오. 외부 고객별 제한이 필요해지면 고객별 API 키와 요청 횟수 제한 방식을 권장합니다.