Retarget
Retarget change la cible d’un conteneur — une nouvelle adresse e-mail, une nouvelle langue, un nouveau groupe de codes — sans changer son crid. Cet appel n’existe que dans l’API 2.1 : la v3 n’a pas d’équivalent, et c’est l’une des deux raisons pour lesquelles une intégration reste sur la 2.1 plutôt que de passer à la v3.
API 2.1
URL de base
{API_BASE}/v2.1 — the base URL is provided with your access
Spécification OpenAPI
Retarget
Méthode POST
/v2.1/client/{key}/{crid}/retarget
Scope
client_v2
Réaffecter le destinataire, la langue ou le groupe de codes d’un conteneur, en conservant le même crid.
Le corps de la requête est entièrement facultatif — n’envoyez que les champs à modifier.
Paramètres
| Nom | Emplacement | Type | Requis | Description |
|---|---|---|---|---|
key |
Chemin | string |
Requis | Votre clé d’API client 2.1. |
crid |
Chemin | string |
Requis | Le crid du conteneur. |
email |
Corps | string |
Facultatif | Nouvelle adresse e-mail du destinataire. |
language |
Corps | string |
Facultatif | Langue appliquée aux interfaces présentées au destinataire de ce conteneur. |
codeGroup |
Corps | string |
Facultatif | Groupe de codes auquel le conteneur est réaffecté. |
additionalData |
Corps | object |
Facultatif | Objet libre, conservé tel quel. |
Réponse
json
200 OK
{
"status": 0,
"url": "https://livstick.io/5f3e9c2b8a1d4f60",
"urid": "5f3e9c2b8a1d4f60",
"urlRead": "https://livstick.io/5f3e9c2b8a1d4f60",
"urlWrite": "https://livstick.io/overwrite/5f3e9c2b8a1d4f60",
"urlPreview": "https://livstick.io/preview/5f3e9c2b8a1d4f60",
"messageUrl": "livstick.io/5f3e9c2b8a1d4f60"
}
Remarques
- url vaut urlWrite ou urlRead selon la plateforme appelante — lisez la page URL d’enregistrement avant d’exploiter ce champ.