Referencia API
Buscar rostro
Busque rostros coincidentes dentro de una colección usando una imagen enviada
POST
Search face in collection
Este endpoint de API le permite buscar rostros coincidentes dentro de una colección usando una imagen facial enviada. El sistema comparará la imagen enviada contra todos los rostros en la colección especificada y devolverá los resultados coincidentes.
Solicitud
Headers
La clave API utilizada para autenticación y control de acceso. Este parámetro de encabezado es requerido para autorización.
Parámetros del Body
Respuesta
Respuesta Exitosa (200)
Opciones y configuraciones adicionales:option_liveness: Indica si la opción de liveness está habilitada o deshabilitada en la configuración.liveNess_threshold: Valor de umbral para la opción de liveness, según lo configurado en los ajustes de umbral de Search Face.liveNessScore: Puntuación que representa el resultado de la verificación de liveness.policy_similarity: Valor de umbral para la opción de similitud.
Lista de IDs de rostros que coinciden con los criterios de búsqueda. Cada elemento en el array es un identificador único para un envío de rostro.
Respuestas de Error
Bad Request (400)
Identifica el error específico para resolución de problemas:
- 6030: CollectionId is required
- 6031: RequestName is required
- 6032: faceImage is missing
- 6033: If the collection information doesn’t exist
- 6034: The collection has already been deleted
- 6035: When a liveness error occurs
- 6036: Image is too large
- 6037: Image is not formatted correctly
- 6038: Unspecified errors
Forbidden (403)
Identifica el error específico para resolución de problemas:
- 6039: API Key is required
- 6040: Access Denied: API Key is unavailable
Documentos relacionados
Descripción general de Face ID
Conozca la API de Face ID para reconocimiento facial y verificación de identidad
Face ID: Cómo funciona
Comprenda el flujo de trabajo e integración de Face ID
Mejores prácticas de Face ID
Mejores prácticas para implementar Face ID en su aplicación
Cuerpo
application/json