Passer au contenu principal
Voici quelques pratiques exemplaires pour la recherche d’utilisateurs :
  • Vous avez besoin d’un jeton pour envoyer des requêtes à la . Pour en savoir plus, consultez Management API Access Tokens.
  • Pour effectuer des requêtes de recherche d’utilisateurs, le scope read:users est requis.
  • Tirez parti de la recherche non déterministe : si votre application n’exige pas un ordre cohérent des résultats de recherche et que vos requêtes sont suffisamment courtes pour ne pas dépendre de la pagination, définissez primary_order=false afin d’améliorer les performances des requêtes.
  • Pour obtenir les résultats de recherche les plus récents, utilisez un point de terminaison à cohérence immédiate pendant les processus d’authentification, comme Get Users by ID et Get Users by Email. Les recherches effectuées au moyen de ces points de terminaison reflètent les résultats de toutes les opérations d’écriture réussies, y compris celles qui ont eu lieu peu avant votre requête.
  • Utilisez un schéma reconnu pour les métadonnées :
    • Utilisez des types de données cohérents pour les propriétés.
    • Évitez les noms de propriété dynamiques.
    • Évitez les schémas volumineux et les structures profondes.
    • Évitez de stocker des données dont vous n’avez pas besoin à des fins d’authentification et d’autorisation.
  • Les requêtes de recherche expirent (code d’état HTTP 503) si elles ne sont pas exécutées en deux secondes ou moins. Les requêtes qui prennent plus de temps indiquent soit qu’elles sont coûteuses, soit qu’elles contiennent une erreur qui les empêche de se terminer rapidement.
  • Les requêtes de recherche comprenant des attributs définis par l’utilisateur dans app_metadata et user_metadata peuvent expirer. Nous vous conseillons de ne pas utiliser List or search users pour des opérations critiques.
  • N’utilisez pas de critère de recherche qui renvoie un grand volume de données (plus de 1000 résultats).
  • N’utilisez pas de requêtes de présence (par exemple, « donnez-moi tous les utilisateurs avec une propriété, peu importe sa valeur »).
  • N’interrogez pas les API de recherche en boucle.
  • N’effectuez pas de requêtes de recherche d’utilisateurs dans les points d’extension du flux de connexion, comme les Rules ou les Actions post-login.
  • N’utilisez pas de champs de métadonnées volumineux (essayez de limiter les champs de métadonnées à 2 Ko ou moins).
  • L’utilisation de caractères génériques dans les recherches peut nuire aux performances. Dans certains cas, les recherches avec caractères génériques sur de grands ensembles de données peuvent entraîner des erreurs d’expiration. Nous recommandons également d’éviter les caractères génériques placés avant le terme de recherche; lorsqu’ils sont utilisés comme suffixes, les performances sont meilleures.
  • Échappez le caractère d’espace pour améliorer les performances (p. ex., q=name:John Doe devrait être écrit q=name:John\ Doe).