Khóa Public API
Settings → Developers → API, tạo và quản lý các khóa API gắn với không gian làm việc cho tích hợp bên ngoài.
Hãy dùng khóa API khi tích hợp không phải là MCP client: một cầu nối Zapier, một dịch vụ nội bộ, một tác vụ báo cáo.
PRO access required (cần gói Pro): hãy nâng cấp không gian làm việc này lên Pro trước khi cấp khóa Public API. Admin access required (cần quyền quản trị): chỉ chủ sở hữu và quản trị viên mới có thể tạo hoặc quản lý khóa.
Tạo khóa
Phần tiêu đề “Tạo khóa”Create key, cấp một khóa gắn với không gian làm việc, có scope rõ ràng và ngày hết hạn cố định.
| Trường | Ghi chú |
|---|---|
| Key name | Ví dụ Zapier CRM bridge. Bắt buộc |
| Scopes | Chỉ cấp mức truy cập tối thiểu mà tích hợp này cần. Ít nhất một scope |
| Expiry date | Mọi khóa đều phải hết hạn. Khoảng thời gian khuyến nghị: 30 đến 90 ngày |
| IP allowlist | Tùy chọn. Mỗi dòng một IP hoặc CIDR, hoặc phân cách bằng dấu phẩy, ví dụ 203.0.113.10, 198.51.100.0/24 |
Các scope có sẵn
Phần tiêu đề “Các scope có sẵn”Workspace access · Members access · Accounts access · Contacts access · Chats access / Chats write · Custom fields read / write · Messages read / Messages write · Tickets read / Tickets write.
Messages write gửi tin nhắn Telegram dưới danh nghĩa các tài khoản của bạn. Chỉ cấp scope này khi tích hợp thực sự cần gửi tin.
Lưu trữ khóa
Phần tiêu đề “Lưu trữ khóa”Khóa dạng văn bản thuần chỉ được hiển thị một lần:
Store this API key now (hãy lưu khóa API này ngay): khóa dạng văn bản thuần chỉ hiển thị một lần. Sau khi đóng hộp thoại này, bạn chỉ còn thấy phần tiền tố. Hãy lưu khóa vào trình quản lý mật khẩu hoặc trình quản lý secret trước khi đóng hộp thoại.
Entergram chỉ lưu hash của khóa. Không có tùy chọn “hiển thị lại khóa”.
Quản lý khóa
Phần tiêu đề “Quản lý khóa”Danh sách hiển thị Active keys (khóa đang hoạt động) và Total keys (tổng số khóa), với trạng thái Active, Expired hoặc
Revoked. Show archived ({n}) hiển thị các khóa đã ngừng dùng.
Với mỗi khóa:
| Trường | |
|---|---|
| Scopes | Khóa được làm gì |
| Created / Created by | Nguồn gốc |
| Expires | Hạn chót cứng |
| Last used | Hiển thị Never cho đến lần dùng đầu tiên |
| Usage | Hoạt động gửi request |
| Source IP | Nơi phát ra các lệnh gọi |
| User agent | Hiển thị No requests yet cho đến lần dùng đầu tiên |
| IP allowlist | Hoặc No IP restrictions configured for this key |
Thao tác
Phần tiêu đề “Thao tác”| Thao tác | Tác dụng |
|---|---|
| Copy key | Chỉ khả dụng khi hộp thoại hiển thị một lần còn mở |
| Rotate | ”The current key will be revoked and replaced with a newly generated key.” (Khóa hiện tại sẽ bị thu hồi và thay bằng một khóa mới được tạo.) |
| Revoke | ”This key will stop working immediately for all clients using it.” (Khóa này sẽ ngừng hoạt động ngay lập tức với mọi client đang dùng nó.) |
| Docs | Mở tài liệu tham chiếu API |
Các sự kiện trong vòng đời khóa đều được ghi nhật ký kiểm toán: Public API key created / rotated / revoked xuất hiện trong Log history.
Xoay vòng khóa không gián đoạn
Phần tiêu đề “Xoay vòng khóa không gián đoạn”Xoay vòng sẽ thu hồi khóa cũ ngay lúc khóa mới được cấp, vì vậy hãy lên kế hoạch trước:
- Tạo một khóa thứ hai với cùng các scope.
- Triển khai khóa mới vào tích hợp của bạn.
- Kiểm tra lưu lượng trên khóa mới qua Last used / Usage.
- Revoke khóa cũ.
Dùng hai khóa rồi thu hồi khóa cũ tốt hơn nhiều so với xoay vòng một khóa đang chạy rồi chạy đua với việc triển khai.
Thực hành tốt
Phần tiêu đề “Thực hành tốt”- Mỗi tích hợp một khóa. Khóa dùng chung nghĩa là bạn không thể thu hồi một thứ mà không làm hỏng ba thứ khác.
- Hết hạn sau 30-90 ngày, đúng như ứng dụng khuyến nghị. Việc buộc phải xoay vòng chính là mục đích.
- Luôn đặt IP allowlist khi bên gọi có IP cố định. Nhờ vậy một khóa bị lộ chỉ còn là chuyện phiền toái, không phải thảm họa.
- Đặt tên khóa theo hệ thống, không theo người.
- Kiểm tra Last used trước khi gia hạn. Một khóa không ai dùng chỉ toàn là rủi ro.
Khắc phục sự cố
Phần tiêu đề “Khắc phục sự cố”| Thông báo | Ý nghĩa |
|---|---|
| PRO access required | Nâng cấp không gian làm việc |
| Admin access required | Bạn không phải chủ sở hữu hoặc quản trị viên |
| Public API key management is temporarily unavailable | Lỗi tạm thời, hãy thử lại sau ít phút |
| Public API hashing not configured | Lỗi cấu hình phía máy chủ, hãy liên hệ bộ phận hỗ trợ |
| Public API storage not ready | Đang chờ một bản migration cơ sở dữ liệu, hãy liên hệ bộ phận hỗ trợ |
Liên quan
Phần tiêu đề “Liên quan”- MCP connectors, dành cho AI client
- Danh sách kiểm tra quyền riêng tư
Tùy chọn cookie
Chúng tôi tôn trọng quyền riêng tư của bạn. Hãy chọn cookie muốn cho phép, lựa chọn của bạn áp dụng cho toàn bộ trang web. Chính sách cookie
Cần thiết để trang web hoạt động, gồm cả việc ghi nhớ lựa chọn riêng tư của bạn. Luôn bật.
Giúp chúng tôi hiểu cách trang web được sử dụng và ghi nhận lượt đăng ký cho đối tác giới thiệu. Tùy chọn.