Post
Richieste richieste: 1
URL |
https://gender-api.com/v2/gender
|
Headers |
Content-Type: application/json
|
JSON Payload |
Campo |
Tipo |
Richieste |
Descrizione |
first_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
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 |