# Migrera från GenderAPI v1 till v2

> Flytta en GenderAPI-integration från v1 till v2 med samma API-nyckel och balans. Kartförfrågningsfält, batchrutter, svar, fel och försök igen.

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

Last reviewed: 2026-09-25

## Flytta en integration från v1 till v2

V1 förblir tillgänglig. Migrera individuella integrationer när du är klar med samma nyckel och kreditsaldo. V2 är ett annat förfrågnings- och svarskontrakt, så det räcker inte att bara ändra webbadressen.

| V1 koncept | V2 ekvivalent |
| --- | --- |
| Separata slutpunkter för namn, e-post och användarnamn | POST /api/v2/gender med type och value |
| Separera flera ändpunkter | POST /api/v2/gender/batch med items |
| askToAI | options.ai_mode: fallback; enstaka förfrågningar är redan fallback som standard |
| forceToGenderize | Samma valfria fält för alla tre typerna; dataset först, sedan smeknamnsmedveten AI |
| Platta svarsfält | data för resultatet; meta för åtkomst och fakturering |
| probability procent | confidence på en skala 0–1 plus confidence_kind; AI-poäng är inte kalibrerade sannolikheter |
| total_names | data.sample_count, nullbar |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Äldre felformat | HTTP status plus Problem Details code och action |
| POST försöker igen | Varje nytt försök är en ny operation med normal fakturering |

- [Läs v1-referensen](https://www.genderapi.io/sv/api-documentation/v1)
- [Använd v2 OpenAPI-kontraktet](https://api.genderapi.io/api/v2/openapi.json)

## Uppdatera och verifiera din klient

Använd v2-begäran och svarskontraktet för integrationen du migrerar. Verifiera meta.access.mode, bevara JSON null-resultat, inspektera batchfel per artikel och kontrollera faktureringen innan du försöker igen. Behåll v1-integrationer på sina befintliga vägar tills deras klienter har uppdaterats.

- [Börja med autentisering](https://www.genderapi.io/sv/docs/v2/authentication)
- [Läs ett v2-svar](https://www.genderapi.io/sv/docs/v2/responses)
- [Hantera försök igen](https://www.genderapi.io/sv/docs/v2/errors-and-retries)