# Von GenderAPI v1 auf v2 migrieren

> Verschieben Sie eine GenderAPI-Integration von v1 nach v2 mit demselben API-Schlüssel und -Guthaben. Ordnen Sie Anforderungsfelder, Batch-Routen, Antworten, Fehler und Wiederholungsverhalten zu.

Canonical HTML: https://www.genderapi.io/de/docs/v2/migration

Last reviewed: 2026-09-25

## 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 |

- [Lesen Sie die v1-Referenz](https://www.genderapi.io/de/api-documentation/v1)
- [Verwenden Sie den v2 OpenAPI-Vertrag](https://api.genderapi.io/api/v2/openapi.json)

## 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.

- [Beginnen Sie mit der Authentifizierung](https://www.genderapi.io/de/docs/v2/authentication)
- [Lesen Sie eine v2-Antwort](https://www.genderapi.io/de/docs/v2/responses)
- [Behandelt Wiederholungsversuche](https://www.genderapi.io/de/docs/v2/errors-and-retries)