Bỏ qua tới nội dung
RexAPFTài liệuMở RexAPF Web
Tài liệuAPIAPI Gateway
APIWeb

Quản lý khoá API

Tạo, đổi nhãn, thay thế, thu hồi và xoá khoá API dùng để gọi API Gateway.

3 phút đọc
Trên trang này
  1. Giới hạn số khoá theo gói
  2. Tạo khoá mới
  3. Mở hộp thoại
  4. Đặt nhãn
  5. Sao chép khoá
  6. Đọc bảng khoá
  7. Thay thế khoá
  8. Thu hồi và xoá khoá
  9. Thu hồi
  10. Xoá khỏi danh sách
  11. Bảo quản khoá
  12. Liên quan

Khoá API xác thực mọi yêu cầu bạn gửi tới API Gateway. Bạn quản lý khoá ở API Gateway › Khóa API (/api-gateway/dashboard/keys).

Giới hạn số khoá theo gói

Mỗi gói có số khoá đang hoạt động tối đa. Thanh … / … khóa đang dùng phía trên bảng cho biết bạn đã dùng bao nhiêu. Thẻ Hạn mức gói trên trang Tổng quan cũng hiện dòng Khóa API · Tối đa ….

Khi đạt giới hạn, nút Tạo khóa API bị vô hiệu và trang hiện thông báo Đã đạt giới hạn — thu hồi một khóa hoặc nâng cấp gói để tạo thêm. Chỉ khoá trạng thái Hoạt động mới tính vào giới hạn; khoá Đã thu hồi thì không.

Tạo khoá mới

  1. Mở hộp thoại

    Nhấn Tạo khóa API ở góc trên bên phải.

  2. Đặt nhãn

    Nhập Nhãn dễ nhận biết, ví dụ “Ứng dụng production”. Nhãn dài 1–100 ký tự. Nhấn Tạo khóa.

  3. Sao chép khoá

    Hộp thoại Khóa API đã được tạo hiện khoá đầy đủ và Endpoint. Nhấn Sao chép cạnh khoá, lưu vào nơi an toàn, rồi nhấn Tôi đã lưu khóa.

rexapf.com/api-gateway/dashboard/keys
Tạo mớiMáy tínhPhòngQuy trìnhTự động hoáPhê duyệtBộ nhớThành phẩmAPI GatewayKết nốiKỹ năngTrợ lý của tôiKênh
API Gateway
  1. 1Cảnh báo Hãy sao chép khóa ngay bây giờ.
  2. 2Nhấn Sao chép để chép toàn bộ khoá
  3. 3Endpoint https://rexapf.com/v1 để dán vào công cụ
  4. 4Nhấn Tôi đã lưu khóa để đóng
Khoá đầy đủ chỉ hiện một lần sau khi tạo
Khoá chỉ hiển thị một lần

Vì lý do bảo mật, khoá đầy đủ không thể xem lại sau khi đóng hộp thoại. Bảng chỉ hiện Tiền tố khóa (dạng sk_9r_xxxxxxxx_…). Nếu làm mất khoá, hãy dùng Thay thế để lấy khoá mới.

Đọc bảng khoá

Bảng có các cột Nhãn, Tiền tố khóa, Trạng thái, Sử dụng, Ngày tạo và Thao tác.

  • Nhãn — nhấn vào nhãn của khoá đang hoạt động để sửa. Nhấn Enter để lưu, Esc để huỷ.
  • Tiền tố khóa — nhấn biểu tượng sao chép để chép tiền tố, hữu ích khi đối chiếu với log.
  • Sử dụng — hiện Dùng lần cuối: … hoặc Chưa dùng.

Phía trên bảng là thẻ Endpoint URL với nút Sao chép, và khung mẹo dùng context hợp lý (có thể ẩn).

Thay thế khoá

Dùng khi khoá bị lộ hoặc bị mất. Nhấn Thay thế trên dòng khoá, rồi Thay thế khóa để xác nhận. Khoá cũ bị thu hồi ngay, khoá mới có nhãn kèm hậu tố “replacement” và hiện một lần trong hộp thoại.

Cập nhật khoá mới vào ứng dụng ngay sau khi thay thế, vì khoá cũ không còn dùng được.

Thu hồi và xoá khoá

  1. Thu hồi

    Nhấn Thu hồi trên dòng khoá, đọc cảnh báo rồi nhấn Thu hồi khóa. Mọi ứng dụng đang dùng khoá này ngừng hoạt động ngay; yêu cầu sau đó nhận lỗi 401 với mã api_key_revoked.

  2. Xoá khỏi danh sách

    Khoá đã thu hồi hiện nút Xoá. Nhấn Xoá, rồi Xoá khóa để gỡ khoá khỏi danh sách.

Lưu ý

Thu hồi không thể hoàn tác. Nếu chỉ muốn đổi khoá, dùng Thay thế để có khoá mới ngay.

Bảo quản khoá

  • Lưu khoá trong biến môi trường hoặc trình quản lý bí mật, không ghi thẳng vào mã nguồn.
  • Dùng mỗi khoá cho một ứng dụng để dễ theo dõi chi phí theo khoá ở Sử dụng › Phân tích.
  • Thu hồi ngay khoá không còn dùng.
~/.zshrc
export REXAPF_API_KEY="sk_9r_..."

Liên quan

Tổng quan & Base URLEndpoint và cách gửi khoá trong header.Sử dụng & thanh toánLọc chi phí theo từng khoá.Mã lỗi & giới hạnLỗi xác thực và giới hạn.
Trang này có hữu ích không?Cập nhật 22/10/2026