Chuyển tích hợp từ v1 sang v2
V1 vẫn còn. Di chuyển các tích hợp riêng lẻ khi sẵn sàng sử dụng cùng một khóa và số dư tín dụng. V2 là một hợp đồng yêu cầu và phản hồi khác nên chỉ thay đổi URL là không đủ.
| Khái niệm V1 | V2 tương đương |
|---|---|
| Tách biệt các điểm cuối tên, email và tên người dùng | POST /api/v2/gender với type và value |
| Tách nhiều điểm cuối | POST /api/v2/gender/batch với items |
| askToAI | options.ai_mode: fallback; các yêu cầu đơn lẻ đã được mặc định là fallback |
| forceToGenderize | Trường tùy chọn giống nhau cho cả ba loại; tập dữ liệu trước, sau đó là AI nhận biết biệt hiệu |
| Trường phản hồi phẳng | data cho kết quả; meta để truy cập và thanh toán |
| probability phần trăm | confidence trên thang điểm 0–1 cộng với confidence_kind; Điểm AI không phải là xác suất được hiệu chỉnh |
| total_names | data.sample_count, vô giá trị |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Định dạng lỗi kế thừa | Trạng thái HTTP cộng với Problem Details code và action |
| POST thử lại | Mỗi lần thử lại là một thao tác mới với hóa đơn bình thường |
Cập nhật và xác minh khách hàng của bạn
Sử dụng hợp đồng yêu cầu và phản hồi v2 cho tiện ích tích hợp mà bạn đang di chuyển. Xác minh meta.access.mode, bảo toàn kết quả JSON null, kiểm tra lỗi lô từng mặt hàng và kiểm tra thanh toán trước khi thử lại. Giữ tích hợp v1 trên đường dẫn hiện có của họ cho đến khi khách hàng của họ được cập nhật.