키 및 환경
Langsys 프로젝트는 두 종류의 API 키를 발급합니다. 어떤 키를 사용할지는 새 문구를 탐색하는지(개발), 완성된 번역을 표시하기만 하는지(프로덕션)에 따라 달라집니다. 두 키 모두 대시보드에서 생성하며, 방법은 빠른 시작에서 안내합니다.
키 두 개, 역할 두 가지
| 키 유형 | 할 수 있는 일 | 사용처 |
|---|---|---|
| 쓰기 | 번역을 가져오고 동시에 새로 발견된 문구를 프로젝트에 등록합니다. | 개발용 / 서버 측 전용입니다. 공개 번들에 포함하지 마세요. |
| 읽기 전용 | 번역만 가져옵니다. 등록이나 수정은 할 수 없습니다. | 프로덕션 / 브라우저. 클라이언트 코드에 포함해도 안전합니다. |
읽기 전용 키가 브라우저에서 안전한 이유. 이 키는 물리적으로 쓰기가 불가능하므로, 누군가 악용해 봐야 사용자가 이미 보고 있는 공개 번역을 읽는 것이 전부입니다. 키를 둘로 나누는 이유가 바로 여기에 있습니다.
일반적인 흐름
- 쓰기 키로 개발하세요. UI를 만드는 동안 새 문구가 발견되고 등록되어, 대상 로케일로 기계 번역됩니다.
- 문구가 확정되면 배포된 앱을 읽기 전용 키로 전환하세요.
- 사용자는 완성된 카탈로그를 가져올 뿐이며, 사용자가 가진 어떤 것으로도 프로젝트를 변경할 수 없습니다.
# .env.local — development
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key # discovers + registers new phrases# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key # only fetches — safe to ship프로젝트에 포함된 항목
이 키는 앱의 번역 범위를 정의하는 프로젝트에 대해 인증합니다.
- 기본 로케일 — 원본 문구가 작성된 언어;
- 대상 로케일 모음 — 문구가 기계 번역되는 모든 언어입니다.
- 기계 번역 설정 — 제공자 등급과 새 문구의 자동 번역 여부.
이 데모를 로컬에서 실행하시나요? 읽기 전용 키를 사용해 SDK가 자체 인스턴스를 바라보도록 설정하세요. 프로젝트의 .env.example을 참고하세요. 그렇지 않으면 패널은 데모 모드(원문 텍스트만 표시)로 실행됩니다.