Preguntas frecuentes

Una búsqueda puede ser ambigua cuando un nombre se utiliza en diferentes poblaciones o cuando la evidencia disponible no apoya una categoría confiable. Para una respuesta no resuelta, el valor de género es la cadena literal "null", no null en JSON. Trate este valor como desconocido, preserve el resultado y su contexto, y nunca force un resultado no resuelto en un valor binario.

Para obtener un resultado de precisión defensible es necesario tener una población de prueba con fecha, método de muestreo, separación entre entrenamiento y prueba, umbral de clasificación, cobertura de casos desconocidos, y resultados segmentados por país y sistema de escritura. También debe informarse sobre la calibración de probabilidades y los conteos de muestra. GenderAPI no publica un porcentaje sin esa evidencia; utilice la probabilidad devuelta como señal de confianza y valide el desempeño en sus datos representativos.

Una explicación útil de la proveniencia identifica las categorías de fuentes, los criterios de selección, las limitaciones geográficas y de escritura, las comprobaciones de calidad, las restricciones de licencias y los procesos de eliminación sin exponer registros protegidos. Utilice la descripción canónica de la proveniencia de GenderAPI para los límites actualmente revelados; no infiera contenidos de conjuntos de datos privados ni cifras a escala de base de datos que no estén documentadas explícitamente.

GenderAPI no publica una frecuencia de actualización fija universal para cada fuente subyacente o regla de procesamiento. Cuando importa el momento de la actualización, utilice la fecha de revisión y el alcance indicados en la documentación de proveniencia canónica, y pregunte al soporte sobre el conjunto de datos o flujo específico en lugar de asumir que todos los registros se actualizan según un mismo cronograma.

Revisar las páginas canónicas de GDPR y Política de Privacidad para obtener la descripción actual de los roles de procesamiento, derechos, canales de contacto, límites de retención y medidas de protección. En el caso de un DPA, un subprocesador, una transferencia o una solicitud del titular de datos que afecte a su organización, contacte a GenderAPI y confíe en el acuerdo ejecutado y en la política actual en lugar de un resumen general de preguntas frecuentes.

Envíe solicitudes POST desde código del lado del servidor de confianza con su clave de API en el encabezado Authorization utilizando el esquema Bearer. Guarde la clave en una variable de entorno o en un gestor de secretos, establezca el tipo de contenido JSON y nunca exponga la credencial en código de navegador. Revise la página de autenticación y el contrato OpenAPI actual antes del uso en producción.

No invente un límite de solicitudes por segundo cuando el contrato actual no lo publique. Aplicar reintentos limitados solo a fallos transitivos o del servidor, usar retroceso exponencial con jitter, y detenerse después de un pequeño número configurado de intentos. Los fallos de autenticación, entrada inválida, acceso, cuota y expiración deben corregirse en lugar de reintentarse sin cambios.

Revise tanto el resultado HTTP como el campo de estado JSON, porque los fallos de validación en tiempo real y de autenticación se devolvieron dentro de respuestas HTTP 200. Cuando el estado es falso, tome decisiones basadas en el errno documentado en lugar de analizar el contenido del mensaje. Valide las entradas antes de enviarlas, elimine credenciales y datos personales de los registros, y asocie los fallos permanentes a acciones correctivas en lugar de reintentarlos sin cambios.

Llame al punto de finalización remaining-usage desde código de monitoreo en servidor confiable con la clave de API en su parámetro de consulta documentado; la verificación en tiempo real encontró que la autenticación Bearer fue rechazada para esta operación. Nunca exponga esa URL en código de navegador, registros, análisis o capturas de pantalla. Trate los valores remaining y expiresAt como señales operativas, elimine la URL completa de la solicitud y confirme los términos comerciales en la cuenta autenticada.

Desarrolle sobre el documento OpenAPI canónico y registre la versión del contrato utilizada por su integración. La política de ciclo de vida aprobada conserva el comportamiento de legacy hasta que se midan los usos, se notifique al cliente y se complete el período de migración. Antes de actualizar, compara esquemas y ejemplos, ejecuta pruebas de contrato para respuestas exitosas y de error, y mantén un camino de deshacer cambios. La publicación sigue controlada por la puerta de liberación compartida.

Utilice una fuente de estado o de monitoreo aprobada por el propietario una vez que se designe. No repita un porcentaje de disponibilidad sin un intervalo de medición, componentes monitoreados, exclusiones y evidencia fechada. Para su propia integración, monitoree independientemente el éxito de las solicitudes, la latencia y las categorías de errores, y distinga un incidente de servicio de autenticación, cuota, entrada inválida o fallos de red locales.