logoDocumentation
Rechercher

API de suppression d'utilisateur

Prérequis

Une fois qu'un utilisateur est supprimé, il ne peut pas être restauré. Les utilisateurs supprimés ne peuvent recevoir à nouveau des messages que dans les cas suivants :

  • Web : effacez les cookies du navigateur puis retournez sur votre site web.
  • Mobile : rouvrez l'application ou désinstallez puis réinstallez l'application pour réinitialiser le SDK. Il est recommandé de mettre à jour le SDK de votre application vers la dernière version.

Recommandations avant la suppression

  1. Interroger les informations de tag et d'alias : utilisez l'API de tag alias pour interroger les alias et tags actuellement liés au registration_id à supprimer.

  2. Vérifier l'audience : vérifiez attentivement l'audience à supprimer.

    ❗️Avertissement : ne supprimez pas tous les utilisateurs. Soyez très prudent lors de ces étapes afin de vous assurer que tous les utilisateurs ne sont pas supprimés.

Description de l'API de suppression d'utilisateur

Cette API permet de supprimer un utilisateur existant (registration_id). Elle supprimera toutes les données associées, les tags liés, les alias, les informations sur l'appareil et les informations de fuseau horaire. Cette suppression est effectuée de manière asynchrone.

Endpoint

DELETE /v4/devices/{registration_id}
              
              DELETE /v4/devices/{registration_id}

            
Afficher ce bloc de code dans la fenêtre flottante

En-tête de la requête

DELETE /v4/devices/{registration_id} Authorization: Basic (chaîne d'authentification base64) Accept: application/json
              
              DELETE /v4/devices/{registration_id}
Authorization: Basic (chaîne d'authentification base64)
Accept: application/json

            
Afficher ce bloc de code dans la fenêtre flottante

Paramètres de la requête

Nom Obligatoire Description
Registration ID Oui L'identifiant unique de l'appareil dans le système Engagelab. La suppression par lot n'est pas prise en charge.

Exemple de requête

DELETE /v4/devices/abc123 Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l Accept: application/json
              
              DELETE /v4/devices/abc123
Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
Accept: application/json

            
Afficher ce bloc de code dans la fenêtre flottante

Exemple de réponse

Réponse réussie

HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "success": true }
              
              HTTP/1.1 200 OK 
Content-Type: application/json; charset=utf-8
{
  "success": true
}

            
Afficher ce bloc de code dans la fenêtre flottante

Réponse d'erreur

{ "error":{ "code":27002, "message":"unknown error" } }
              
              {
  "error":{
    "code":27002, 
    "message":"unknown error"
    }
}

            
Afficher ce bloc de code dans la fenêtre flottante
icon
Contactez-nous