Spostare un'integrazione da V1 a V2
GenderAPI.io V1 resta disponibile. Porta ogni integrazione a V2 con la stessa chiave API e lo stesso saldo di crediti. V2 ha un contratto di richiesta e risposta diverso, quindi non basta cambiare l'URL: aggiorna insieme route, campi della richiesta e gestione delle risposte. V2 usa data per i risultati e meta per le informazioni su richiesta, accesso e addebito.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender con type: name, email o username e value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch con items; i tipi di input possono essere combinati. |
| /api/phone con number e address | POST /api/v2/phone/validate con number e country; leggi data.valid e data.possible. |
| askToAI | options.ai_mode: fallback; le richieste singole usano già fallback per impostazione predefinita |
| forceToGenderize | Stesso campo facoltativo per tutti e tre i tipi; prima il set di dati, poi l'IA con interpretazione dei nickname |
| Campi di risposta non annidati | data per il risultato; meta per accesso e addebito |
| probability come percentuale | confidence su una scala da 0 a 1 più confidence_kind; i valori dell'IA non sono probabilità calibrate |
| total_names | data.sample_count, può essere null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Formato di errore precedente | Stato HTTP più code e action di Problem Details |
| Nuovi tentativi POST | Ogni nuovo tentativo è una nuova operazione con addebito normale |
Aggiornare e verificare il client
Usa il contratto di richiesta e risposta di V2 per l'integrazione che stai migrando. Verifica meta.access.mode, conserva i risultati JSON null, controlla gli errori dei singoli elementi nei batch e verifica l'addebito prima di riprovare. Lascia le integrazioni V1 sui percorsi attuali finché i relativi client non sono stati aggiornati.