Przenieś integrację z wersji 1 do wersji 2
Wersja 1 pozostaje dostępna. Przeprowadź migrację poszczególnych integracji, gdy będą gotowe, przy użyciu tego samego klucza i salda środków. Wersja 2 to inny kontrakt żądania i odpowiedzi, więc zmiana samego adresu URL nie wystarczy.
| Koncepcja V1 | Odpowiednik V2 |
|---|---|
| Oddzielne punkty końcowe zawierające nazwę, adres e-mail i nazwę użytkownika | POST /api/v2/gender z type i value |
| Oddziel wiele punktów końcowych | POST /api/v2/gender/batch z items |
| askToAI | options.ai_mode: fallback; pojedyncze żądania są już domyślnie ustawione na fallback |
| forceToGenderize | To samo pole opcjonalne dla wszystkich trzech typów; najpierw zbiór danych, a następnie sztuczna inteligencja rozpoznająca pseudonimy |
| Płaskie pola odpowiedzi | data dla wyniku; meta dla dostępu i rozliczeń |
| probability procent | confidence w skali 0–1 plus confidence_kind; Wyniki AI nie są skalibrowanymi prawdopodobieństwami |
| total_names | data.sample_count, dopuszczający wartość null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Starszy format błędu | Stan HTTP plus Problem Details code i action |
| POST ponawia próbę | Każda ponowna próba to nowa operacja z normalnym rozliczeniem |
Zaktualizuj i zweryfikuj swojego klienta
Użyj umowy żądań i odpowiedzi w wersji 2 dla integracji, którą migrujesz. Zweryfikuj meta.access.mode, zachowaj wyniki JSON null, sprawdź błędy wsadowe poszczególnych pozycji i sprawdź rozliczenia przed ponowną próbą. Zachowaj integracje v1 na istniejących ścieżkach, dopóki ich klienci nie zostaną zaktualizowani.