Saltar al contenido principal
Estas son algunas prácticas recomendadas para la búsqueda de usuarios:
  • Necesita un token para realizar solicitudes a la . Para obtener más información, consulte Tokens de acceso de la Management API.
  • Para realizar solicitudes de búsqueda de usuarios, se requiere el scope read:users.
  • Aproveche la búsqueda no determinista: si su aplicación no requiere un orden consistente de los resultados de búsqueda y sus consultas son lo bastante breves como para no depender de la paginación, establezca primary_order=false para mejorar el rendimiento de la consulta.
  • Para obtener los resultados de búsqueda más recientes, use un endpoint de consistencia inmediata durante los procesos de autenticación, como Obtener usuarios por ID y Obtener usuarios por correo electrónico. Las búsquedas que usan estos endpoints reflejan los resultados de todas las operaciones de escritura correctas, incluidas las que ocurrieron poco antes de su solicitud.
  • Use un esquema conocido para los metadatos:
    • Use tipos de datos consistentes para las propiedades.
    • Evite los nombres de propiedad dinámicos.
    • Evite esquemas grandes y estructuras profundas.
    • Evite almacenar datos que no necesite para fines de autenticación y autorización.
  • Las consultas de búsqueda agotan el tiempo de espera (código de estado HTTP 503) si no se completan en dos segundos o menos. Las consultas que tardan más indican que se trata de una consulta costosa o que la consulta tiene un error que impide que se complete rápidamente.
  • Las consultas de búsqueda con atributos definidos por el usuario en app_metadata y user_metadata pueden agotar el tiempo de espera. Le recomendamos que no use Enumerar o buscar usuarios para operaciones críticas.
  • No use un criterio de búsqueda que devuelva un conjunto de datos grande (más de 1000 resultados).
  • No use consultas de existencia (por ejemplo, “dame todos los usuarios con una propiedad independientemente de su valor”).
  • No consulte repetidamente las API de búsqueda.
  • No realice solicitudes de búsqueda de usuarios dentro de los puntos de extensión del flujo de inicio de sesión, como Rules o las Actions post-login.
  • No use campos de metadatos grandes (intente mantenerlos en 2 KB o menos).
  • El uso de comodines en las búsquedas puede afectar al rendimiento. En algunos casos, las búsquedas con comodines en conjuntos de datos grandes pueden producir errores por tiempo de espera. También recomendamos evitar los comodines prefijados al término de búsqueda, mientras que usarlos como sufijos ofrece un mejor rendimiento.
  • Escape el carácter de espacio para mejorar el rendimiento (p. ej., q=name:John Doe debe escribirse como q=name:John\ Doe).