Referencia API
Obtener lista de rostros
Recupere una lista de todos los rostros contenidos dentro de una colección específica
GET
Get list of faces in collection
Este endpoint de API le permite recuperar una lista de todos los rostros contenidos dentro de una colección específica. Puede usar la paginación y la funcionalidad de búsqueda para gestionar eficientemente grandes colecciones de datos faciales.
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 de Consulta
Recupera una lista de faceIds que contienen una cadena específica. (Debe tener al menos 5 caracteres de longitud)
Respuesta
Respuesta Exitosa (200)
Array de objetos de rostros que contiene:collection_id: Identificador único de la colección de rostrosface_id: Identificador único del rostro en la colecciónuser_name: Nombre del usuario asociado al rostrocreate_time: Marca de tiempo de cuando se agregó el rostrometa_face_id: Un identificador de metadatos para el rostro
Representa el número total de rostros encontrados que coinciden con los criterios de búsqueda. En este ejemplo, solo se encuentra un rostro, pero este valor podría ser mayor si se detectan más coincidencias.
Respuestas de Error
Bad Request (400)
Identifica el error específico para resolución de problemas:
- 6024: CollectionId is required
- 6025: Term string is less than 5 characters long
- 6026: Page is missing
- 6027: Collection information does not exist
- 6028: This collection is unavailable
- 6029: Fail to get Face list
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