Khóa & môi trường
Một dự án Langsys cấp hai loại khóa API. Loại bạn dùng tùy thuộc vào việc bạn đang phát hiện các cụm từ mới (phát triển) hay chỉ hiển thị các bản dịch đã hoàn tất (sản xuất). Cả hai đều được tạo trong bảng điều khiển — phần Bắt đầu nhanh sẽ hướng dẫn chi tiết.
Hai khóa, hai nhiệm vụ
| Loại khóa | Có thể làm | Sử dụng trong |
|---|---|---|
| Ghi | Tải bản dịch và đăng ký các cụm từ mới phát hiện vào dự án. | Dùng cho phát triển / phía máy chủ. Không đưa vào các bundle công khai. |
| Chỉ đọc | Chỉ lấy bản dịch. Không thể đăng ký hay chỉnh sửa bất cứ thứ gì. | Môi trường production / trình duyệt. An toàn để đưa vào mã phía máy khách. |
Vì sao khóa chỉ đọc an toàn trong trình duyệt. Về mặt vật lý, nó không thể ghi — điều tệ nhất ai đó có thể làm với nó là đọc những bản dịch công khai mà người dùng của bạn vốn đã thấy. Đó chính là mục đích của việc tách khóa.
Quy trình thông thường
- Phát triển với khóa ghi. Khi bạn xây dựng giao diện, các cụm từ mới sẽ được phát hiện, đăng ký và dịch máy sang các ngôn ngữ đích của bạn.
- Khi nội dung đã ổn định, hãy chuyển ứng dụng đã triển khai sang dùng khóa chỉ đọc.
- Người dùng tải về danh mục bản dịch hoàn chỉnh; không thứ gì họ nắm giữ có thể thay đổi dự án của bạn.
# .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 shipMột dự án chứa những gì
Khóa này xác thực với một dự án, nơi xác định phạm vi bản dịch cho ứng dụng của bạn:
- một ngôn ngữ gốc — ngôn ngữ mà các cụm từ nguồn của bạn được viết bằng;
- một tập hợp ngôn ngữ đích — tất cả những ngôn ngữ mà các cụm từ được dịch máy sang;
- cài đặt dịch máy — cấp nhà cung cấp và việc có tự động dịch các cụm từ mới hay không.
Đang chạy các bản demo này cục bộ? Hãy trỏ SDK tới phiên bản của riêng bạn bằng khóa chỉ đọc — xem .env.example của dự án. Nếu không, các bảng sẽ chạy ở chế độ demo (chỉ hiển thị văn bản gốc).