Przenieś integrację z V1 do V2
Wersja V1 GenderAPI.io pozostaje dostępna. Migruj poszczególne integracje do V2, gdy będziesz gotowy, z tym samym kluczem API i saldem kredytów. V2 ma inny kontrakt zapytań i odpowiedzi, więc sama zmiana adresu URL nie wystarczy: zaktualizuj jednocześnie trasę, pola zapytania i analizę odpowiedzi. V2 zwraca wyniki w data, a informacje o zapytaniu, dostępie i rozliczeniu w meta.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender; użyj type: name, email lub username oraz value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch; items przyjmuje różne typy danych wejściowych w jednej partii. |
| /api/phone z number i address | POST /api/v2/phone/validate; wyślij number i country, a następnie odczytaj data.valid i data.possible. |
| askToAI | options.ai_mode: fallback; pojedyncze zapytania domyślnie mają już fallback |
| forceToGenderize | To samo opcjonalne pole dla wszystkich trzech typów; najpierw zbiór danych, potem AI uwzględniająca pseudonimy |
| Płaskie pola odpowiedzi | data dla wyniku; meta dla dostępu i rozliczeń |
| probability w procentach | confidence w skali 0–1 wraz z confidence_kind; wyniki AI nie są skalibrowanymi prawdopodobieństwami |
| total_names | data.sample_count, może mieć wartość null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Starszy format błędu | Status HTTP oraz code i action z Problem Details |
| Ponawianie zapytań POST | Każda ponowna próba to nowa operacja rozliczana normalnie |
Zaktualizuj i zweryfikuj swojego klienta
Użyj kontraktu zapytań i odpowiedzi V2 dla migrowanej integracji. Weryfikuj meta.access.mode, zachowuj wyniki JSON null, sprawdzaj błędy poszczególnych elementów partii i sprawdzaj rozliczenie przed ponowną próbą. Pozostaw integracje V1 na ich obecnych ścieżkach, dopóki ich aplikacje klienckie nie zostaną zaktualizowane.