# cjkword.com 업로드 안내

서버에 올릴 폴더는 다음 하나입니다.

```text
server_upload/api
```

서버의 최종 위치는 다음입니다.

```text
/var/www/html/api
```

즉, 로컬의 `server_upload/api` 안쪽 내용이 서버의 `/var/www/html/api` 안쪽 내용이 되도록 올리면 됩니다.

## 서버에 올라가야 하는 주요 파일

```text
/var/www/html/api/_lib/caw.php
/var/www/html/api/v1/caw/type-letter-hold.php
/var/www/html/api/v1/caw/plain-convert.php
/var/www/html/api/example/simple_editor.html
/var/www/html/api/caw_data/combined_characters_sorted.json
/var/www/html/api/caw_data/radical_map_184.json
/var/www/html/api/sdk/js/caw-api-sdk.js
```

## 업로드 후 확인 주소

아래 주소는 API/SDK 공개 예제입니다. 고객이 설치와 연동 상태를 확인할 수 있도록 비밀번호 없이 열려도 괜찮습니다.

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

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

## JSON 파일 노출을 줄이는 방법

브라우저에서 JSON 파일을 직접 열지 못하게 하려면 서버 설정에서 `/api/caw_data` 접근을 차단하면 됩니다. PHP API는 같은 서버 파일시스템에서 JSON을 읽기 때문에, 웹으로 직접 JSON 파일을 열 수 없어도 정상 작동할 수 있습니다.