⚡ API Unificata v2.0 AVANZATO

DOCUMENTAZIONE API

Prova la nostra API unificata ad alte prestazioni, progettata per utenti avanzati con alti volumi di richieste. Interroga più nomi in una singola richiesta con tempi di risposta fulminei.

Cerca per nome completo - DIVIDI NOME E COGNOME

Se usi un campo combinato per nome e cognome sulla tua pagina, utilizza questa API per estrarre le parti:

POST https://gender-api.com/v2/gender

info Richieste richieste: 1

http Headers

Content-Type: application/json

Authorization: Bearer <token di autorizzazione>

link

data_object JSON Payload

Campo	Tipo	Richieste	Descrizione
`full_name`	string	Sì	Nome da cercare
`country`	string	Sì	Codice Paese ISO 3166 ALPHA-2 link
`locale`	string	Sì	Locale del Browser
`ip`	string	Sì	Indirizzo IPv4 o IPv6 valido
`id`	string	Sì	Max 50 caratteri. Puoi impostare questo ID a qualsiasi valore alfanumerico desideri. Ad esempio, puoi impostare l'ID al tuo ID interno del dataset nel tuo database. In un ambiente asincrono, questo può aiutarti a collegare meglio la risposta a una richiesta precedente

code Esempi di richieste

arrow_forward Cerca solo per nome completo

play_arrow Provalo in tempo reale su Codepen.io

{
    "full_name": "Theresa Miller"
}

arrow_forward Cerca per nome completo e codice paese

play_arrow Provalo in tempo reale su Codepen.io

{
    "full_name": "Theresa Miller",
    "country": "US"
}

arrow_forward Cerca per nome completo e impostazioni locali del browser

play_arrow Provalo in tempo reale su Codepen.io

{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

arrow_forward Interrogare per nome completo e utilizzare un indirizzo IP per la localizzazione

play_arrow Provalo in tempo reale su Codepen.io

{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

arrow_forward Richiedi più nomi in un'unica richiesta

play_arrow Provalo in tempo reale su Codepen.io

[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

check_circle Risposta

{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

list Campi della risposta

Campo	Tipo	Descrizione
`input`	object	Il payload inviato
`details.credits_used`	int	Il numero di richieste utilizzate per questa query
`details.samples`	int	Il numero di record trovati nel nostro database che corrispondono alla tua richiesta
`details.country`	string	Il paese che abbiamo trovato
`details.full_name_sanitized`	int	Il nome dopo che abbiamo applicato il nostro normalizzatore
`details.duration`	string	Tempo necessario al server per elaborare la richiesta
`result_found`	bool	True se siamo stati in grado di interrogare un genere per il nome dato
`full_name`	string	Il nome completo utilizzato per la generazione del genere
`probability`	float	Questo valore (compreso tra 0 e 1) determina l'affidabilità del nostro database. Un valore di 1 significa che i risultati sulla richiesta di genere sono accurati al 100%.
`gender`	string	Valori possibili: maschio, femmina, sconosciuto