Mã lỗi GenderAPI

Cấu trúc phản hồi

Đọc đối tượng lỗi

Khi yêu cầu thất bại, phản hồi JSON trả status là false. Dùng errno dạng số cho logic ứng dụng và giữ errmsg cho log hoặc chẩn đoán dễ đọc.

JSON · lỗi mẫu

{
  "status": false,
  "errno": 94,
  "errmsg": "invalid or missing key"
}

Quy tắc triển khai: Phân nhánh theo errno, không dựa vào nguyên văn errmsg. Cách này giúp tích hợp ổn định nếu phần mô tả thay đổi sau này.

Bảng tra cứu đầy đủ

Các giá trị sau khớp với tài liệu GenderAPI công khai hiện tại. Hãy khắc phục nguyên nhân trước khi gửi lại yêu cầu.

errno50

access denied

Yêu cầu đến từ địa chỉ IP hoặc referrer không được phép.

Kiểm tra giới hạn truy cập được gán cho API key.

errno90

invalid country code

Giá trị quốc gia không phải mã ISO 3166-1 alpha-2 được hỗ trợ.

Kiểm tra và chuẩn hóa mã quốc gia trước khi thử lại.

errno91

name not set || email not set || username not set

Yêu cầu thiếu tham số name, email hoặc username bắt buộc.

Thêm dữ liệu đầu vào bắt buộc cho endpoint đang gọi.

errno92

too many names || too many emails || too many usernames

Yêu cầu vượt giới hạn lô: 100 tên, 50 email hoặc 50 username.

Chia dữ liệu thành các lô nhỏ hơn và gửi riêng.

errno93

query limit reached

API key không còn credit.

Tạm dừng tác vụ tra cứu và bổ sung số dư tài khoản.

errno94

invalid or missing key

API key bị thiếu hoặc không được tìm thấy.

Kiểm tra cách nạp thông tin xác thực và dùng key máy chủ hợp lệ.

errno99

API key has expired

Gói liên kết với API key đã hết hạn.

Gia hạn gói trước khi gửi lượt tra cứu khác.

Hướng dẫn xử lý

Xử lý lỗi an toàn và tránh thử lại mù quáng

Kiểm tra đầu vào trước

Loại bỏ dữ liệu thiếu, mã quốc gia sai và lô quá lớn trước khi gửi đến API.

Bảo vệ thông tin xác thực

Giữ API key trên máy chủ và che key trong log ứng dụng, đầu ra trình duyệt và ảnh hỗ trợ.

Chỉ thử lại khi phù hợp

Các lỗi này cần sửa yêu cầu hoặc xử lý tài khoản. Gửi lại nguyên yêu cầu sẽ không giải quyết được lỗi.

TypeScript · kiểm tra phản hồi

type GenderApiError = {
  status: false;
  errno: number;
  errmsg: string;
};

if (response.status === false) {
  handleGenderApiError(response.errno, response.errmsg);
}

Giữ thông tin chẩn đoán ở chế độ riêng tư

Ghi số lỗi cùng mã yêu cầu nội bộ nhưng không bao giờ ghi API key. Hiển thị thông báo ngắn gọn, có thể hành động thay vì để lộ thông tin xác thực hoặc dữ liệu nội bộ.

Hoàn tất tài liệu

Tiếp tục phát triển với GenderAPI

Mức sử dụng và hạn mứcTheo dõi credit khả dụng →Bảng giáSo sánh các gói credit →

Xử lý lỗi API một cách chủ động

Đọc đối tượng lỗi