Fusionner les utilisateurs
/users/merge
Utilisez cet endpoint pour fusionner un utilisateur dans un autre.
Vous pouvez spécifier jusqu’à 50 fusions par requête. Cet endpoint est asynchrone.
Résolution des problèmes
Une réponse de succès a été renvoyée, mais l’utilisateur fusionné apparaît toujours dans les recherches
Une réponse de succès confirme que la requête a bien été acceptée, mais l’opération de fusion se déroule en deux étapes : la fusion des profils, puis la suppression du profil source. C’est pourquoi le profil identifier_to_merge peut encore apparaître dans les recherches du tableau de bord pendant un court moment après une réponse de succès. Ce comportement est normal : patientez quelques minutes, puis vérifiez que la fusion est terminée.
Si l’utilisateur fusionné existe toujours après plusieurs minutes, vérifiez que les identifiants de votre requête sont corrects et qu’ils appartiennent à des utilisateurs du même espace de travail que la clé API utilisée pour la requête.
Référence des erreurs
Le tableau suivant répertorie les messages d’erreur que vous pouvez rencontrer.
| Erreur | Résolution des problèmes |
|---|---|
'merge_updates' must be an array of objects |
Vérifiez que merge_updates est un tableau d’objets. |
a single request may not contain more than 50 merge updates |
Vous ne pouvez pas spécifier plus de 50 mises à jour de fusion dans une seule requête. |
identifiers must be objects with an 'external_id' property that is a string, 'user_alias' property that is an object, 'email' property that is a string, or 'phone' property that is a string |
Vérifiez les identifiants de votre requête. |
'merge_updates' must only have 'identifier_to_merge' and 'identifier_to_keep' |
Vérifiez que merge_updates contient uniquement les deux objets identifier_to_merge et identifier_to_keep. |
Vous pouvez télécharger le document OpenAPI et l’utiliser pour valider les schémas. Pour savoir comment procéder, consultez Utiliser les schémas OpenAPI pour la validation des requêtes.