Μετακινήστε μια ολοκλήρωση από το v1 στο v2
Το V1 παραμένει διαθέσιμο. Μεταφέρετε μεμονωμένες ενσωματώσεις όταν είστε έτοιμοι χρησιμοποιώντας το ίδιο κλειδί και το ίδιο πιστωτικό υπόλοιπο. Το V2 είναι μια διαφορετική σύμβαση αιτήματος και απάντησης, επομένως η αλλαγή μόνο της διεύθυνσης URL δεν αρκεί.
| Έννοια V1 | ισοδύναμο V2 |
|---|---|
| Διαχωρίστε τα τελικά σημεία ονόματος, email και ονόματος χρήστη | POST /api/v2/gender με type και value |
| Διαχωρίστε πολλαπλά τελικά σημεία | POST /api/v2/gender/batch με items |
| askToAI | options.ai_mode: fallback; Τα μεμονωμένα αιτήματα είναι ήδη από προεπιλογή fallback |
| forceToGenderize | Ίδιο προαιρετικό πεδίο και για τους τρεις τύπους. πρώτα σύνολο δεδομένων και μετά AI με επίγνωση ψευδώνυμων |
| Επίπεδα πεδία απόκρισης | data για το αποτέλεσμα. meta για πρόσβαση και χρέωση |
| probability ποσοστό | confidence σε κλίμακα 0–1 συν confidence_kind; Οι βαθμολογίες AI δεν είναι βαθμονομημένες πιθανότητες |
| total_names | data.sample_count, μηδενικό |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Μορφή σφάλματος παλαιού τύπου | κατάσταση HTTP συν Problem Details code και action |
| Επανάληψη του POST | Κάθε επανάληψη είναι μια νέα λειτουργία με κανονική χρέωση |
Ενημερώστε και επαληθεύστε τον πελάτη σας
Χρησιμοποιήστε το συμβόλαιο αίτησης και απάντησης v2 για την ενσωμάτωση που πραγματοποιείτε μετεγκατάσταση. Επαληθεύστε το meta.access.mode, διατηρήστε τα αποτελέσματα JSON null, επιθεωρήστε τα σφάλματα παρτίδας ανά είδος και ελέγξτε τη χρέωση πριν δοκιμάσετε ξανά. Διατηρήστε τις ενσωματώσεις v1 στις υπάρχουσες διαδρομές τους μέχρι να ενημερωθούν οι πελάτες τους.