API Docs API Unificata v2.0

API v1.0

Offriamo anche un'altra versione dell'API con endpoint più facili da integrare. Se sei un principiante in materia di implementazione di API, puoi passare al nostro endpoint v1.0.
Visualizza API v1.0

OpenAPI

Visualizza la nostra documentazione API in Swagger

Postman

Importa la nostra definizione API in Postman
Ricerca per nome
Ricerca per nome completo
Query per indirizzo email
Paese di origine
Ottieni statistiche
Codici di Errore

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
Richieste richieste: 1
URL
https://gender-api.com/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <token di autorizzazione>
link
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

Esempi

Cerca solo per nome completo
play_arrow Provalo live su codepen.io 
{"full_name":"Theresa Miller"}
Cerca per nome completo e codice paese
play_arrow Provalo live su codepen.io 
{"full_name":"Theresa Miller","country":"US"}
Cerca per nome completo e impostazioni locali del browser
play_arrow Provalo live su codepen.io 
{"full_name":"Thomas Johnson","locale":"en_US"}
Interrogare per nome completo e utilizzare un indirizzo IP per la localizzazione
play_arrow Provalo live su codepen.io 
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Richiedi più nomi in un'unica richiesta
play_arrow Provalo live su codepen.io 
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
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"
}
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
Questo prodotto include i dati GeoLite2 creati da MaxMind, disponibili su http://www.maxmind.com.
Chat