Quản lý API Key bằng chương trình

Dùng hướng dẫn này để tự động quản lý API Key trong ứng dụng. Nếu chỉ gọi mô hình hoặc cấu hình SDK, xem API Key và xác thực.

Lấy token truy cập

Tạo token truy cập ở mục “Bảo mật” trên trang hồ sơ để quản lý API Key của người dùng đó.

Token truy cập và API Key mô hình có mục đích khác nhau: API quản lý dùng token truy cập; API mô hình dùng API Key. Không dùng lẫn.

Thay your-user-token bằng token truy cập rồi truy vấn danh sách API Key:

curl 'https://api.agtcloud.cn/api/token/?p=1&size=20' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-user-token'

Khi thành công, tìm Key trong data.items, giữ id để đọc chi tiết, cập nhật hoặc xóa. Không có bản ghi thì items là mảng rỗng.

key trong danh sách/chi tiết có thể bị che, không dùng được để gọi mô hình. Xem khóa đầy đủ tại trang API Keys.

Mở Reference tương ứng để xem tham số, ví dụ phản hồi hoặc thử trực tuyến.

Thao tác	Mục đích
Lấy danh sách API Key	Xem API Key theo trang
Tìm API Key	Tìm theo tên hoặc giá trị Key
Lấy một API Key	Đọc cấu hình theo ID
Tạo API Key	Đặt tên, hạn mức, thời hạn và giới hạn truy cập
Cập nhật API Key	Sửa cấu hình hoặc chỉ bật/tắt
Xóa API Key	Xóa một Key
Xóa hàng loạt API Key	Xóa nhiều Key

Để xem hạn mức còn lại của một Key, dùng Tra cứu hạn mức API Key, xác thực bằng chính Key đó, không phải token truy cập.

Kiểm tra mục tiêu trước khi cập nhật hoặc xóa

Cập nhật thường có thể đặt lại trường bị bỏ qua. Đọc chi tiết và gửi đủ cấu hình cần giữ. Nếu chỉ bật/tắt, dùng chế độ chỉ cập nhật trạng thái.

Xóa sẽ ảnh hưởng ứng dụng dùng Key. Kiểm tra ID; không xóa bằng ID ví dụ.

Kiểm tra kết quả nghiệp vụ: HTTP 200 vẫn có thể là lỗi nghiệp vụ; kiểm tra success và message.
Tránh ghi lặp: nếu tạo, sửa hoặc xóa bị hết thời gian, truy vấn trước để xác nhận đã có hiệu lực; không gửi lại ngay.
Bảo vệ token truy cập: lưu ở máy chủ có kiểm soát, không đưa vào frontend, log công khai, ảnh chụp hoặc kho mã. Không lộ URL tìm kiếm chứa giá trị khóa.