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.
Interrogazione per nome
Questo è il modo più facile per verificare il genere di un nome. Ogni risposta è codificata in JSON
Post
Richieste richieste: 1
URL |
https://gender-api.com/v2/gender
|
||||||||||||||||||||||||
Headers |
Content-Type: application/json
Authorization: Bearer <token di autorizzazione>
|
||||||||||||||||||||||||
JSON Payload |
|
Esempi
Interrogazione solo per nome
{"first_name":"Sandra"}
Ricerca per nome e codice paese
{"first_name":"Sandra","country":"US"}
Ricerca per nome e lingua del browser
{"first_name":"Sandra","locale":"en_US"}
Interrogazione per nome e utilizzo di un indirizzo IP per la localizzazione
{"first_name":"Sandra","ip":"54.201.16.177"}
Richiedi più nomi in un'unica richiesta
[{"first_name":"Sandra","country":"US"},{"first_name":"Jason","country":"US"}]
Risposta
{
"input": {
"first_name": "Sandra"
},
"details": {
"credits_used": 1,
"samples": 464,
"country": null,
"first_name_sanitized": "sandra",
"duration": "436ms"
},
"result_found": true,
"first_name": "Sandra",
"probability": 0.85,
"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.first_name_sanitized | string | 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 |
first_name | string | Il primo nome che abbiamo usato per la genderizzazione |
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.