Nutzer:innen zusammenführen
/users/merge
Verwenden Sie diesen Endpunkt, um eine:n Nutzer:in mit einer anderen Person zusammenzuführen.
Pro Anfrage können bis zu 50 Zusammenführungen angegeben werden. Dieser Endpunkt ist asynchron.
Fehlerbehebung
Eine Erfolgsantwort wurde zurückgegeben, aber die zusammengeführte Person ist weiterhin auffindbar
Eine erfolgreiche Antwort bestätigt, dass die Anfrage angenommen wurde. Die Zusammenführung erfolgt jedoch in zwei Schritten: Zuerst werden die Profile zusammengeführt, anschließend wird das Quellprofil entfernt. Daher kann das Profil identifier_to_merge nach einer erfolgreichen Antwort noch kurze Zeit im Dashboard auffindbar sein. Dies ist erwartetes Verhalten – warten Sie einige Minuten und überprüfen Sie dann, ob die Zusammenführung abgeschlossen ist.
Wenn die zusammengeführte Person auch nach mehreren Minuten noch existiert, überprüfen Sie, ob die Bezeichner in Ihrer Anfrage korrekt sind und zu Nutzer:innen im selben Workspace gehören wie der für die Anfrage verwendete API-Schlüssel.
Fehlerreferenz
In der folgenden Tabelle sind mögliche Fehlermeldungen aufgeführt.
| Fehler | Fehlerbehebung |
|---|---|
'merge_updates' must be an array of objects |
Prüfen Sie, ob merge_updates ein Array von Objekten ist. |
a single request may not contain more than 50 merge updates |
Sie können in einer einzelnen Anfrage höchstens 50 Merge-Updates angeben. |
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 |
Überprüfen Sie die Bezeichner in Ihrer Anfrage. |
'merge_updates' must only have 'identifier_to_merge' and 'identifier_to_keep' |
Prüfen Sie, ob merge_updates nur die beiden Objekte identifier_to_merge und identifier_to_keep enthält. |
Sie können das OpenAPI-Dokument herunterladen und damit Schemas validieren. Wie das geht, erfahren Sie unter OpenAPI-Schemas zur Validierung von Anfragen verwenden.