Verschieben Sie eine Integration von v1 nach v2
V1 bleibt verfügbar. Migrieren Sie einzelne Integrationen, wenn Sie bereit sind, mit demselben Schlüssel und demselben Guthaben. V2 ist ein anderer Anfrage- und Antwortvertrag, daher reicht es nicht aus, nur die URL zu ändern.
| V1-Konzept | V2-Äquivalent |
|---|---|
| Separate Namens-, E-Mail- und Benutzernamen-Endpunkte | POST /api/v2/gender mit type und value |
| Mehrere Endpunkte trennen | POST /api/v2/gender/batch mit items |
| askToAI | options.ai_mode: fallback; Einzelanfragen sind bereits standardmäßig auf fallback eingestellt |
| forceToGenderize | Gleiches optionales Feld für alle drei Typen; Zuerst der Datensatz, dann die Spitzname-bewusste KI |
| Flache Antwortfelder | data für das Ergebnis; meta für Zugang und Abrechnung |
| probability Prozentsatz | confidence auf einer Skala von 0–1 plus confidence_kind; KI-Scores sind keine kalibrierten Wahrscheinlichkeiten |
| total_names | data.sample_count, nullable |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Legacy-Fehlerformat | HTTP-Status plus Problem Details code und action |
| POST wiederholt | Jeder Wiederholungsversuch ist ein neuer Vorgang mit normaler Abrechnung |
Aktualisieren und überprüfen Sie Ihren Client
Verwenden Sie den v2-Anfrage- und Antwortvertrag für die Integration, die Sie migrieren. Überprüfen Sie meta.access.mode, bewahren Sie JSON null-Ergebnisse auf, überprüfen Sie Batch-Fehler pro Artikel und überprüfen Sie die Abrechnung, bevor Sie es erneut versuchen. Behalten Sie v1-Integrationen auf ihren bestehenden Pfaden bei, bis ihre Clients aktualisiert wurden.