Documentos de la API Unificada v2.0
API v1.0
También ofrecemos otra versión de la API con puntos finales que son más fáciles de integrar. Si eres un principiante en la implementación de API's puedes cambiar a nuestro endpoint v1.0.
Consulta por correo electrónico
También puede consultar un género utilizando una dirección de correo electrónico que contenga una dirección de correo electrónico:
Publicar
Créditos requeridos: 1
URL |
https://gender-api.com/v2/gender
|
||||||||||||||||||||||||
Headers |
Content-Type: application/json
Authorization: Bearer <us fichas de autorización>
|
||||||||||||||||||||||||
JSON Payload |
|
Ejemplos
Consulta por correo electrónico solamente
{"email":"theresa.miller14@gmail.com"}
Consulta por correo electrónico y código de país
{"email":"thomas.clarks@hotmail.com","country":"US"}
Consulta por dirección de correo electrónico y localización del navegador
{"email":"Thomas.j32@live.com","locale":"en_US"}
Consultar por correo electrónico y utilizar una dirección IP para la localización
{"email":"thomasfromnewyork@gmail.com","ip":"54.201.16.177"}
Consultar varios nombres en una sola solicitud
[{"email":"thomas.clarks@hotmail.com","country":"US"},{"email":"theresa.miller14@gmail.com"}]
Respuesta
{
"input": {
"email": "theresa.miller14@gmail.com"
},
"details": {
"credits_used": 1,
"duration": "12ms",
"samples": 8961,
"country": null,
"first_name_sanitized": "theresa"
},
"result_found": true,
"last_name": "Miller",
"first_name": "Theresa",
"probability": 0.98,
"gender": "female"
}
Campo | Escriba | Descripción |
---|---|---|
input | object | La carga útil enviada |
details.credits_used | int | La cantidad de créditos utilizados para esta consulta |
details.samples | int | Número de registros encontrados en nuestra base de datos que coinciden con su solicitud |
details.country | string | El país que encontramos |
details.email_sanitized | int | El nombre después de que le aplicamos nuestro normalizador |
details.duration | string | El tiempo que el servidor necesitaba para procesar la solicitud |
result_found | bool | Es cierto que si pudiéramos consultar el género del primer nombre |
string | La dirección de correo electrónico que hemos utilizado para la genderización | |
probability | float | Este valor (entre 0 y 1) determina la fiabilidad de nuestra base de datos. Un valor de 1 significa que los resultados de su solicitud de género son 100% exactos. |
gender | string | Valores posibles: masculino, femenino, desconocido |
Este producto incluye datos de GeoLite2 creados por MaxMind, disponibles en http://www.maxmind.com.