Externe ID umbenennen
/users/external_ids/rename
Verwenden Sie diesen Endpunkt, um die externen IDs Ihrer Nutzer:innen umzubenennen.
Sie können bis zu 50 Umbenennungsobjekte pro Anfrage senden.
Dieser Endpunkt legt eine neue (primäre) external_id für die Nutzer:in fest und markiert die bestehende external_id als veraltet. Das bedeutet, dass die Nutzer:in über beide external_id-Werte identifiziert werden kann, bis die veraltete ID entfernt wird. Mehrere externe IDs ermöglichen einen Migrationszeitraum, sodass ältere Versionen Ihrer Apps, die das frühere Namensschema für externe IDs verwenden, weiterhin funktionieren. Das Profil bleibt während des Migrationszeitraums unter beiden Bezeichnern voll funktionsfähig – das Braze SDK, die REST API und die Messaging-Pipelines können die Nutzer:in weiterhin über beide IDs referenzieren, bis die veraltete ID explizit entfernt wird.
Sobald Ihr altes Namensschema nicht mehr verwendet wird, empfehlen wir dringend, veraltete externe IDs über den Endpunkt /users/external_ids/remove zu entfernen.
Stellen Sie sicher, dass Sie veraltete externe IDs mit dem Endpunkt /users/external_ids/remove und nicht mit /users/delete entfernen. Wenn Sie eine Anfrage mit der veralteten externen ID an /users/delete senden, wird das Nutzerprofil vollständig gelöscht. Dies kann nicht rückgängig gemacht werden.
Sie können das OpenAPI-Dokument herunterladen und damit Schemas validieren. Wie das funktioniert, erfahren Sie unter OpenAPI-Schemas zur Validierung von Anfragen verwenden.