API para eliminar usuarios
Requisito previo
Una vez que se elimina un usuario, no se puede restaurar. Los usuarios eliminados solo pueden volver a recibir mensajes en los siguientes escenarios:
- Web: Borrar las cookies del navegador y, a continuación, volver a su sitio web.
- Móvil: Volver a abrir la aplicación o desinstalarla y reinstalarla para reinicializar el SDK. Se recomienda actualizar a la versión más reciente del SDK en la aplicación.
Recomendaciones antes de la eliminación
Consultar la información de etiquetas y alias: Utilizar la API de alias de etiquetas para consultar los alias y las etiquetas actualmente vinculados al registration_id que se va a eliminar.
Verificar la audiencia: Verificar cuidadosamente la audiencia que se va a eliminar.
❗️Advertencia: No eliminar todos los usuarios. Se debe tener mucho cuidado al realizar estos pasos para garantizar que no se eliminen todos los usuarios.
Descripción de la API para eliminar usuarios
Esta API se utiliza para eliminar un usuario (registration_id) existente. Se eliminarán todos los datos relacionados, las etiquetas y los alias vinculados, la información del dispositivo y la información de zona horaria. Esta eliminación se realiza de forma asíncrona.
Endpoint
DELETE /v4/devices/{registration_id}
Encabezado de la solicitud
DELETE /v4/devices/{registration_id}
Authorization: Basic (base64 auth string)
Accept: application/json
Parámetros de la solicitud
| Nombre | Obligatorio | Descripción |
|---|---|---|
| Registration ID | Sí | Identificador único del dispositivo en el sistema EngageLab. No se admite la eliminación por lotes. |
Ejemplo de solicitud
DELETE /v4/devices/abc123
Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
Accept: application/json
Ejemplo de respuesta
Respuesta correcta
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"success": true
}
Respuesta de error
{
"error":{
"code":27002,
"message":"unknown error"
}
}
