Μεταφορά μιας ενσωμάτωσης από το V1 στο V2
Το GenderAPI.io V1 παραμένει διαθέσιμο. Μεταφέρετε κάθε ενσωμάτωση στο V2 με το ίδιο κλειδί API και το ίδιο υπόλοιπο πιστώσεων. Το V2 έχει διαφορετική σύμβαση αιτήματος και απόκρισης, επομένως δεν αρκεί να αλλάξετε το URL. Ενημερώστε μαζί τις διαδρομές, τα πεδία του αιτήματος και τον χειρισμό των αποκρίσεων. Το V2 χρησιμοποιεί το data για τα αποτελέσματα και το meta για τις πληροφορίες αιτήματος, πρόσβασης και χρέωσης.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender με type: name, email ή username και value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch με items. Οι τύποι εισόδου μπορούν να συνδυαστούν. |
| /api/phone με number και address | POST /api/v2/phone/validate με number και country. Διαβάστε τα data.valid και data.possible. |
| askToAI | options.ai_mode: fallback. Τα μεμονωμένα αιτήματα χρησιμοποιούν ήδη από προεπιλογή fallback |
| forceToGenderize | Το ίδιο προαιρετικό πεδίο και για τους τρεις τύπους. Πρώτα το σύνολο δεδομένων και έπειτα AI με ανάλυση ψευδωνύμων |
| Πεδία απόκρισης χωρίς ένθεση | data για το αποτέλεσμα, meta για την πρόσβαση και τη χρέωση |
| probability ως ποσοστό | confidence σε κλίμακα από 0 έως 1 μαζί με confidence_kind. Οι τιμές του AI δεν είναι βαθμονομημένες πιθανότητες |
| total_names | data.sample_count, μπορεί να είναι null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Παλαιά μορφή σφαλμάτων | Κατάσταση HTTP μαζί με τα code και action του Problem Details |
| Νέες προσπάθειες POST | Κάθε νέα προσπάθεια είναι νέα λειτουργία με κανονική χρέωση |
Ενημέρωση και έλεγχος του προγράμματος-πελάτη
Χρησιμοποιήστε τη σύμβαση αιτήματος και απόκρισης του V2 για την ενσωμάτωση που μεταφέρετε. Ελέγξτε το meta.access.mode, διατηρήστε τα αποτελέσματα JSON null, ελέγξτε τα σφάλματα μεμονωμένων στοιχείων στις παρτίδες και επιβεβαιώστε τη χρέωση πριν δοκιμάσετε ξανά. Αφήστε τις ενσωματώσεις V1 στις τρέχουσες διαδρομές τους μέχρι να ενημερωθούν τα αντίστοιχα προγράμματα-πελάτες.