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 nombre completo - DIVIDIR EL NOMBRE Y EL APELLIDO

Si utiliza un campo combinado para el nombre y el apellido en su página, utilice esta API para extraer las partes:

Publicar
Créditos requeridos: 1
URL
https://gender-api.io/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <us fichas de autorización>
link
JSON Payload
Campo Escriba Requerido Descripción
full_name string Si Nombre a consultar
country string No ISO 3166 ALPHA-2 Código de país
link
locale string No Navegador Local
ip string No Dirección IPv4 o IPv6 válida
id string No Máximo 50 caracteres. Puede configurar esta identificación a cualquier valor alfanumérico que desee. Como ejemplo, puede establecer el id a su id interno del conjunto de datos en su base de datos. En un asíncrono ambiente esto puede ayudar a conectar mejor la respuesta a una solicitud anterior

Ejemplos

Consulta sólo por el nombre completo
{"full_name":"Theresa Miller"}
Consulta por nombre completo y código de país
{"full_name":"Theresa Miller","country":"US"}
Consulta por nombre completo y localización del navegador
{"full_name":"Thomas Johnson","locale":"en_US"}
Consulta por nombre completo y utiliza una dirección IP para la localización
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Consultar varios nombres en una sola solicitud
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
Respuesta
{
    "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 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.full_name_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
full_name string El nombre completo que usamos 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.
Chat
Necesitamos su consentimiento
Utilizamos cookies (incluidas las de terceros) para recopilar información sobre los visitantes uso de nuestro sitio web. Estas cookies nos ayudan a proporcionarle la mejor experiencia posible en línea y a mejorar nuestros sitios web. La información recogida a través de las cookies también puede ser tratada fuera de la Unión Europea, por ejemplo, en los Estados Unidos. Al hacer clic en el botón "Aceptar todo", usted acepta el uso de cookies. Para retirar su consentimiento en cualquier momento, cambiar su configuración o para obtener más información sobre el uso de cookies, haga clic aquí o en "Configuración de cookies" al final de la página.