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.
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>
|
||||||||||||||||||||||||
JSON Payload |
|
Esempi
Cerca solo per nome completo
{"full_name":"Theresa Miller"}
Cerca per nome completo e codice paese
{"full_name":"Theresa Miller","country":"US"}
Cerca per nome completo e impostazioni locali del browser
{"full_name":"Thomas Johnson","locale":"en_US"}
Interrogare per nome completo e utilizzare un indirizzo IP per la localizzazione
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Richiedi più nomi in un'unica richiesta
[{"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.