# Migrazione da GenderAPI v1 a v2

> Sposta un'integrazione GenderAPI da v1 a v2 utilizzando la stessa chiave e bilanciamento API. Mappa campi di richiesta, percorsi batch, risposte, errori e comportamento dei nuovi tentativi.

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

Last reviewed: 2026-09-25

## Sposta un'integrazione dalla v1 alla v2

V1 rimane disponibile. Migra le singole integrazioni quando sono pronte utilizzando la stessa chiave e il saldo del credito. V2 è un contratto di richiesta e risposta diverso, quindi modificare solo l'URL non è sufficiente.

| Concetto V1 | Equivalente V2 |
| --- | --- |
| Endpoint separati per nome, email e nome utente | POST /api/v2/gender con type e value |
| Separa più endpoint | POST /api/v2/gender/batch con items |
| askToAI | options.ai_mode: fallback; le richieste singole sono già predefinite su fallback |
| forceToGenderize | Stesso campo opzionale per tutti e tre i tipi; prima il set di dati, poi l'intelligenza artificiale con riconoscimento del nickname |
| Campi di risposta piatti | data per il risultato; meta per accesso e fatturazione |
| probability percentuale | confidence su una scala 0–1 più confidence_kind; I punteggi dell'intelligenza artificiale non sono probabilità calibrate |
| total_names | data.sample_count, annullabile |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Formato errore precedente | Stato HTTP più Problem Details code e action |
| POST riprova | Ogni nuovo tentativo è una nuova operazione con fatturazione normale |

- [Leggi il riferimento v1](https://www.genderapi.io/it/api-documentation/v1)
- [Utilizza il contratto v2 OpenAPI](https://api.genderapi.io/api/v2/openapi.json)

## Aggiorna e verifica il tuo cliente

Utilizza il contratto di richiesta e risposta v2 per l'integrazione di cui stai eseguendo la migrazione. Verifica meta.access.mode, preserva i risultati di JSON null, controlla gli errori batch per articolo e controlla la fatturazione prima di riprovare. Mantieni le integrazioni v1 sui percorsi esistenti fino all'aggiornamento dei client.

- [Inizia con l'autenticazione](https://www.genderapi.io/it/docs/v2/authentication)
- [Leggi una risposta v2](https://www.genderapi.io/it/docs/v2/responses)
- [Gestisci i nuovi tentativi](https://www.genderapi.io/it/docs/v2/errors-and-retries)