Nutzer-Alias aktualisieren

Verwenden Sie diesen Endpunkt, um bestehende Nutzer-Aliase zu aktualisieren.

Pro Anfrage können bis zu 50 Nutzer-Aliase angegeben werden.

Um einen Nutzer-Alias zu aktualisieren, müssen alias_label, old_alias_name und new_alias_name im Objekt „Nutzer-Alias aktualisieren“ enthalten sein. Wenn kein Nutzer-Alias mit alias_label und old_alias_name verknüpft ist, wird kein Alias aktualisiert. Wenn die angegebenen alias_label und old_alias_name gefunden werden, wird old_alias_name auf new_alias_name aktualisiert.

Hinweis

Dieser Endpunkt garantiert nicht die Reihenfolge, in der die alias_updates-Objekte aktualisiert werden.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung users.alias.update.

Rate-Limit

Wir wenden ein gemeinsames Rate-Limit von 20.000 Anfragen pro Minute auf diesen Endpunkt an. Dieses Rate-Limit wird mit den Endpunkten /users/delete, /users/alias/new, /users/identify und /users/merge geteilt, wie in API-Rate-Limits dokumentiert.

Anfragetext

1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

1
2
3
{
  "alias_updates" : (required, array of update user alias object)
}

Anfrageparameter

Anfragetext des Endpunkts mit Spezifikation des Nutzer-Alias-Aktualisierungsobjekts

1
2
3
4
5
{
  "alias_label" : (required, string),
  "old_alias_name" : (required, string),
  "new_alias_name" : (required, string)
}

Beispielanfrage

1
2
3
4
5
6
7
8
9
10
11
12
curl --location --request POST 'https://rest.iad-01.braze.com/users/alias/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
  "alias_updates" :[
    {
      "alias_label": "example_alias_label",
      "old_alias_name" : "example_old_alias_name",
      "new_alias_name" : "example_new_alias_name"
    }
  ]
}'