Lấy khóa API Ody của bạn
Bạn tạo khóa API trong Cài đặt → API nhà phát triển: đặt tên khóa, chọn phạm vi của nó, chọn Trực tiếp hoặc Thử nghiệm, nhấp vào Tạo khóa và sao chép bí mật từ biểu ngữ hiển thị một lần.
Trước khi bạn bắt đầu
- Bạn phải là quản trị viên hoặc chủ sở hữu không gian làm việc để tạo hoặc thu hồi khóa.
- Khóa hoạt động như thành viên đã tạo chúng — chúng không bao giờ có thể làm được nhiều hơn những gì người đó có thể làm trong ứng dụng.
Từng bước một
Nhấp vào Cài đặt trong thanh bên, sau đó API nhà phát triển. (Trên điện thoại của bạn: Thêm → Cài đặt → API nhà phát triển.)
Trong biểu mẫu tạo, nhập tên khóa — ví dụ "Zapier" hoặc "Máy chủ sản xuất" — để bạn có thể phân biệt các khóa sau này.
Chọn phạm vi của khóa bằng cách sử dụng các thẻ bên dưới trường tên. Tất cả mười thẻ đều được chọn trước, tạo thành một khóa truy cập đầy đủ; bỏ chọn các thẻ để thu hẹp phạm vi. Các phạm vi có sẵn là Đọc danh bạ, Quản lý danh bạ, Đọc cuộc trò chuyện, Cập nhật cuộc trò chuyện, Gửi tin nhắn, Đọc số điện thoại, Quản lý webhook, Mua số điện thoại & 10DLC, Thực hiện cuộc gọi AI, và Quản lý tác nhân AI.
Dưới Loại khóa, chọn Trực tiếp hoặc Thử nghiệm. Khóa Trực tiếp bắt đầu bằng
ody_live_và thực hiện mọi thứ thật. Khóa Thử nghiệm bắt đầu bằngody_test_và đọc dữ liệu thật, nhưng việc gửi tin nhắn được ghi lại dưới dạng mô phỏng và không bao giờ được truyền đi — hoàn hảo cho việc xây dựng và CI. Xem Xây dựng an toàn với chế độ thử nghiệm.Nhấp vào Tạo khóa.
Sao chép khóa từ biểu ngữ màu xanh lá cây — "Sao chép khóa mới của bạn ngay bây giờ — bạn sẽ không thấy nó nữa." Ody chỉ lưu trữ một hàm băm, vì vậy văn bản gốc chỉ hiển thị chính xác một lần.
Lưu trữ khóa như một mật khẩu — trong trình quản lý bí mật hoặc biến môi trường, không bao giờ trong mã phía máy khách hoặc tài liệu được chia sẻ.
Quản lý các khóa hiện có
Bên dưới biểu mẫu tạo, mỗi khóa được liệt kê với tên của nó, một gợi ý bị che (ody_live_…WXYZ hoặc ody_test_…WXYZ), một huy hiệu Thử nghiệm cho các khóa thử nghiệm, phạm vi của nó dưới dạng thẻ ("Truy cập đầy đủ" khi không bị hạn chế), và thời điểm nó được sử dụng lần cuối. Nhấp vào Thu hồi để vô hiệu hóa khóa ngay lập tức — các khóa đã thu hồi sẽ ngừng xác thực ngay lập tức và không thể khôi phục.
Bài viết liên quan
- Tổng quan API và xác thực
- Xây dựng an toàn với chế độ thử nghiệm
- Kết nối công cụ AI với MCP
- Giới hạn tốc độ API và các phương pháp hay nhất
Các câu hỏi thường gặp
Tôi đã mất khóa API của mình — tôi có thể xem lại không?
Không. Khóa đầy đủ chỉ hiển thị chính xác một lần, tại thời điểm tạo. Hãy thu hồi khóa đã mất và tạo một khóa mới.
Sự khác biệt giữa khóa Trực tiếp và Thử nghiệm là gì?
Khóa Trực tiếp (ody_live_…) gửi tin nhắn thật. Khóa Thử nghiệm (ody_test_…) hoạt động tương tự nhưng việc gửi tin nhắn được mô phỏng — ghi lại trong luồng, không bao giờ được truyền đi.
Ai có thể tạo khóa API?
Quản trị viên và chủ sở hữu không gian làm việc. Khóa hoạt động với quyền hạn của thành viên đã tạo chúng.
Những gói nào bao gồm API?
Tất cả các gói — API và MCP được bao gồm bắt đầu từ gói Starter.