Tổng quan hạn mức
Kiểm tra dung lượng trước khi xử lý
Dùng endpoint credit còn lại trong tác vụ giám sát, bảng điều khiển nội bộ hoặc quy trình hàng loạt. Endpoint trả về phản hồi gọn mà không thực hiện tra cứu giới tính.
Endpoint credit còn lại
Lấy thông tin hạn mức
Thêm API key dưới dạng tham số query key. Chỉ gửi yêu cầu từ máy chủ để không làm lộ thông tin xác thực cho khách truy cập.
https://api.genderapi.io/api/remaining?key=YOUR_API_KEYcurl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"Phản hồi mẫu
Số dư và thời hạn
{
"status": true,
"remaining": 9443,
"expiresAt": 1752651601
}Các trường phản hồi
| Trường | Kiểu | Mô tả |
|---|---|---|
status | boolean | true khi yêu cầu thành công và API key hợp lệ. |
remaining | integer | Số credit API hiện đang khả dụng. |
expiresAt | integer | Package expiration expressed as a Dấu thời gian UNIX in seconds. |
Hướng dẫn vận hành
Thiết lập giám sát hạn mức để hành động sớm
Hiển thị dung lượng hiện tại
Hiển thị số dư trong bảng điều khiển nội bộ cho đội vận hành và hỗ trợ.
Đặt ngưỡng cảnh báo
Cảnh báo trước khi số dư về 0 để có thời gian bổ sung credit.
Bảo vệ quy trình hàng loạt
So sánh credit khả dụng với kích thước lô dự kiến trước khi chạy tác vụ.
Dùng ngưỡng phù hợp với lưu lượng của bạn thay vì một con số chung.
- Ổn địnhCòn trên 20%
- Cảnh báoCòn 10–20%
- Nghiêm trọngCòn dưới 10%
Lập kế hoạch khi cạn hạn mức
Không đợi lỗi API mới phát hiện số dư đã cạn. Giám sát theo lịch hợp lý, tránh kiểm tra trước từng lượt tra cứu và xác định cách ứng dụng tạm dừng hoặc thử lại.
Tài liệu tiếp theo