Tích hợp

Tài khoản & API key

Đăng nhập, quản lý tài khoản và lấy API key

Phân biệt tài khoản và API key

Tài khoản dùng để đăng nhập dashboard. API key dùng để một ứng dụng gọi News Hub. Không dùng API key thay mật khẩu và không chia sẻ key qua email hoặc ảnh chụp.

Quản lý phiên đăng nhập

News Hub gửi liên kết đăng nhập tới email. Chỉ mở liên kết bạn vừa yêu cầu và kiểm tra đúng tên miền trước khi tiếp tục. Khi dùng máy lạ, hãy đăng xuất sau khi hoàn tất.

Tạo API key

  1. Vào Settings → Keys hoặc khu vực key tương ứng.
  2. Đặt tên mô tả thiết bị hoặc mục đích sử dụng.
  3. Tạo và sao chép key khi nó xuất hiện.
  4. Lưu key ở nơi an toàn.

Một số key chỉ hiển thị đầy đủ một lần. Nếu làm mất, cách an toàn là thu hồi và tạo key mới.

Quyền và mục đích sử dụng

Nếu giao diện hiển thị loại hoặc phạm vi key, hãy chọn quyền ít nhất đáp ứng nhu cầu. Dùng key riêng cho MCP, script cá nhân và từng thiết bị để dễ thu hồi mà không làm gián đoạn mọi nơi.

Thu hồi key

Thu hồi ngay khi:

  • Key xuất hiện trong kho mã hoặc log công khai.
  • Thiết bị bị mất.
  • Ứng dụng không còn sử dụng.
  • Bạn không nhận ra tên key hoặc hoạt động liên quan.

Sau khi thu hồi, cập nhật ứng dụng bằng key mới nếu vẫn cần kết nối.

Giới hạn sử dụng

API có thể áp dụng giới hạn theo gói và theo khoảng thời gian. Khi gặp lỗi giới hạn, giảm tần suất gọi, tránh gửi truy vấn lặp và chờ thời gian được nêu trong phản hồi.

Cấu hình an toàn

  • Dùng biến môi trường hoặc kho bí mật.
  • Không commit file chứa key.
  • Che key trước khi chụp màn hình.
  • Không gửi toàn bộ key cho người hỗ trợ.

Câu hỏi thường gặp

Key không hoạt động? Kiểm tra key có bị thu hồi, sao chép thiếu ký tự hoặc dùng sai loại endpoint không.

Nhận lỗi không có quyền? Key có thể không phù hợp với thao tác đó. Kiểm tra loại key và tài liệu của bề mặt đang dùng.