Quitar un contacto de un dataset

DELETE/v1/datasets/{id}/contacts/{identifier}

Para desarrolladores

Descripción

Quita un contacto de un dataset. El contacto se indica por el valor del identificador con que el dataset reconoce a un contacto: su correo, su teléfono o su código único, según cómo se haya creado el dataset.

Quitar no es excluir. El contacto deja de estar en este dataset, pero si vuelve a entrar por un formulario conectado o por POST /v1/datasets/{id}/contacts, reaparece. Los demás datasets y los envíos no se ven afectados. Para que una persona deje de recibir comunicaciones, use una desuscripción.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope dataset:write. Formato: Bearer <API_KEY>.

X-Instance-Slugstringheaderobligatorio

Identificador de su instancia. Ver Autenticación.

Request

Path params:

idintegerobligatorio

Identificador del dataset.

identifierstringobligatorio

El correo, teléfono o código único del contacto, según el identificador del dataset. Se normaliza como al registrarlo: [email protected] encuentra a [email protected]. Codifique los caracteres especiales para la URL (un + como %2B).

Response

204 No ContentEl contacto se quitó.

Errores

Código	Cuándo
404	El dataset no existe (dataset_not_found), o no tiene un contacto con ese identificador.

Notas

• Cada contacto quitado queda en el registro de actividad de la instancia, junto con la API key que lo pidió.
• Repetir la llamada sobre un contacto ya quitado responde 404.

Request

curl -X DELETE "https://cl1api.fidelizador.com/v1/datasets/7/contacts/ana%40ejemplo.cl" \
-H "Authorization: Bearer <API_KEY>" \
-H "X-Instance-Slug: <slug>"

Response

Sin cuerpo: la respuesta no trae contenido.