Renommer l’ID externe
/users/external_ids/rename
Utilisez cet endpoint pour renommer les ID externes de vos utilisateurs.
Vous pouvez envoyer jusqu’à 50 objets de renommage par requête.
Cet endpoint définit un nouvel external_id (principal) pour l’utilisateur et rend son external_id existant obsolète. L’utilisateur peut donc être identifié par l’un ou l’autre des external_id jusqu’à ce que l’ID obsolète soit supprimé. Disposer de plusieurs ID externes permet de prévoir une période de migration, afin que les anciennes versions de vos applications qui utilisent l’ancien schéma de dénomination des ID externes continuent de fonctionner. Le profil reste pleinement fonctionnel sous les deux identifiants pendant la période de migration : le Braze SDK, la REST API et les pipelines d’envoi de messages peuvent continuer à référencer l’utilisateur par l’un ou l’autre des ID jusqu’à ce que l’ID obsolète soit explicitement supprimé.
Une fois que votre ancien schéma de dénomination n’est plus utilisé, nous vous recommandons vivement de supprimer les ID externes obsolètes à l’aide de l’endpoint /users/external_ids/remove.
Veillez à supprimer les ID externes obsolètes à l’aide de l’endpoint /users/external_ids/remove plutôt que /users/delete. L’envoi d’une requête à /users/delete avec l’ID externe obsolète supprime entièrement le profil utilisateur, et cette action est irréversible.
Vous pouvez télécharger le document OpenAPI et l’utiliser pour valider des schémas. Pour savoir comment procéder, consultez Utiliser les schémas OpenAPI pour valider les requêtes.