Tracking Preferences: Lectura
Obtener historial
Cada cambio de un destinatario, del más reciente al más antiguo: qué eligió, cuándo y quién lo cambió. Tu registro de consentimiento para auditorías.
https://g.sendcorex.com/v1/privacycommand: get_historyRequiere el scope privacy:read en tu API key.
El historial se conserva mientras exista la preferencia. Cada entrada es el estado completo después de ese cambio.
Argumentos
emailstringobligatorioLa dirección del destinatario.
p. ej.
"jane.doe@example.com"limitnumberopcionalCuántos cambios, de 1 a 500. Por defecto, 50.
p. ej.
50
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/privacy',
{
commands: [
{
command: "get_history",
args: {
email: "jane.doe@example.com",
limit: 50
}
}
]
},
{ 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_history",
"id": "0",
"type": "SUCCESS",
"took_ms": 6,
"data": {
"history": [
{
"email": "jane.doe@example.com",
"track_opens": false,
"track_clicks": true,
"source": "page",
"updated_at": "2026-10-24T07:20:12.031Z"
},
{
"email": "jane.doe@example.com",
"track_opens": true,
"track_clicks": true,
"source": "api",
"updated_at": "2026-09-02T10:05:41.220Z"
}
]
}
}
]
}Campos de la respuesta
historyLos cambios, del más reciente al más antiguo. Vacío cuando el destinatario nunca tuvo una preferencia.
history[].emailLa dirección del destinatario, en minúsculas.
history[].track_openstrueel destinatario permite el seguimiento de aperturas,falselo rechazó,nullnunca eligió.history[].track_clickstrueel destinatario permite el seguimiento de clics,falselo rechazó,nullnunca eligió.history[].sourceQuién hizo el cambio:
page(el destinatario, en la página de preferencias de tracking),api(tú, con Set Preferences) odashboard.history[].updated_atCuándo se hizo el cambio. ISO 8601, UTC.
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.