Chuyển một tích hợp từ V1 sang V2
V1 vẫn tiếp tục hoạt động. Hãy chuyển từng tích hợp khi sẵn sàng, với cùng khóa và số dư tín dụng. V2 có hợp đồng yêu cầu và phản hồi khác, vì vậy chỉ thay URL là không đủ.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender với type là name, email hoặc username, kèm value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch với items; có thể kết hợp các loại đầu vào khác nhau. |
| /api/phone với number và address | POST /api/v2/phone/validate với number và country; đọc data.valid và data.possible. |
| askToAI | options.ai_mode: fallback; yêu cầu đơn lẻ đã mặc định là fallback |
| forceToGenderize | Cùng một trường tùy chọn cho cả ba loại; tra tập dữ liệu trước, sau đó dùng AI có phân tích biệt danh |
| Các trường phản hồi ở cùng một cấp | data cho kết quả; meta cho quyền truy cập và tính phí |
| probability dạng phần trăm | confidence trên thang từ 0 đến 1 cùng confidence_kind; điểm của AI không phải xác suất đã hiệu chỉnh |
| total_names | data.sample_count, có thể là null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Định dạng lỗi cũ | Trạng thái HTTP cùng code và action của Problem Details |
| Thử lại POST | Mỗi lần thử lại là một thao tác mới, được tính phí như bình thường |
Cập nhật và kiểm tra client
Dùng hợp đồng yêu cầu và phản hồi của V2 cho tích hợp bạn đang chuyển đổi. Kiểm tra meta.access.mode, giữ nguyên kết quả JSON null, kiểm tra lỗi của từng mục trong lô và kiểm tra việc tính phí trước khi thử lại. Giữ các tích hợp V1 trên đường dẫn hiện tại cho đến khi client của chúng được cập nhật.