Tracking Preferences: Lectura
Obtener preferencias
La elección de seguimiento de aperturas y clics de un destinatario. Una consulta por dirección, sin escaneo.
https://g.sendcorex.com/v1/privacycommand: get_preferencesRequiere el scope privacy:read en tu API key.
preference es null cuando el destinatario nunca abrió la página de preferencias de tracking y tú nunca le definiste nada.
Argumentos
emailstringobligatorioLa dirección del destinatario. Las mayúsculas no importan.
p. ej.
"jane.doe@example.com"
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/privacy',
{
commands: [
{
command: "get_preferences",
args: {
email: "jane.doe@example.com"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "get_preferences",
"id": "0",
"type": "SUCCESS",
"took_ms": 6,
"data": {
"preference": {
"email": "jane.doe@example.com",
"track_opens": false,
"track_clicks": true,
"source": "page",
"updated_at": "2026-10-24T07:20:12.031Z"
}
}
}
]
}Campos de la respuesta
preferenceLa preferencia de abajo, o
nullcuando no hay ninguna.preference.emailLa dirección del destinatario, en minúsculas.
preference.track_openstrueel destinatario permite el seguimiento de aperturas,falselo rechazó,nullnunca eligió.preference.track_clickstrueel destinatario permite el seguimiento de clics,falselo rechazó,nullnunca eligió.preference.sourceQuién hizo el cambio:
page(el destinatario, en la página de preferencias de tracking),api(tú, con Set Preferences) odashboard.preference.updated_atCuándo se hizo el cambio. ISO 8601, UTC.
Cómo afecta a tus envíos
El rechazo siempre ganaCuando
track_opensotrack_clicksesfalse, ese tracking se deja fuera del email aunque tu envío lo pida con"track_opens": true.Nunca eligióCuando el valor es
null(o el destinatario no tiene ninguna preferencia), decide tu envío, exactamente como antes.Requiere nuestro motor de bajasLas preferencias se aplican a los envíos con
"unsubscribe": true. Eso es también lo que pone el enlace de preferencias en el email.Tu valor por defectoPara reglas de opt-in (por ejemplo, Francia), envía
"track_opens": falsey"track_clicks": falsehasta que el destinatario lo permita, y lee la preferencia con Get Many antes de enviar.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_API_KEYLa API key no existe, fue revocada o se desactivó en el dashboard.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 simultáneas para la misma IP + API key. Espera el número de segundos indicado en Retry-After.
- CMD
MISSING_SCOPELa API key no tiene el scope de este comando (`privacy:read` para leer, `privacy:write` para modificar).
- CMD
INVALID_ARGSUn argumento no es válido: `email` ausente o mal formado, más de 100 `emails`, `track_opens` que no es `true`/`false`, limit fuera de rango…
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.