Tracking Preferences: Lesen
Einstellungen abrufen
Die Wahl eines Empfängers zum Tracking von Öffnungen und Klicks. Ein Lookup per Adresse, kein Scan.
https://g.sendcorex.com/v1/privacycommand: get_preferencesErfordert den Scope privacy:read für Ihren API key.
preference ist null, wenn der Empfänger die Seite für Tracking-Präferenzen nie geöffnet hat und Sie nie etwas für ihn gesetzt haben.
Argumente
emailstringerforderlichDie Empfängeradresse. Groß-/Kleinschreibung spielt keine Rolle.
z. B.
"jane.doe@example.com"
Schnellstart
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);Antwort
{
"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"
}
}
}
]
}Antwortfelder
preferenceDie Präferenz unten oder
null, wenn es keine gibt.preference.emailDie Empfängeradresse, in Kleinbuchstaben.
preference.track_openstrueder Empfänger erlaubt das Tracking von Öffnungen,falseer hat es abgelehnt,nuller hat nie gewählt.preference.track_clickstrueder Empfänger erlaubt das Tracking von Klicks,falseer hat es abgelehnt,nuller hat nie gewählt.preference.sourceWer die Änderung vorgenommen hat:
page(der Empfänger, auf der Seite für Tracking-Präferenzen),api(Sie, mit Set Preferences) oderdashboard.preference.updated_atWann die Änderung erfolgte. ISO 8601, UTC.
Wie es sich auf Ihre Sendungen auswirkt
Ablehnung hat immer VorrangWenn
track_opensodertrack_clicksfalseist, wird dieses Tracking aus der E-Mail weggelassen, auch wenn Ihr Versand es mit"track_opens": trueanfordert.Nie gewähltWenn der Wert
nullist (oder der Empfänger gar keine Präferenz hat), entscheidet Ihr Versand, genau wie bisher.Erfordert unsere Abmelde-EnginePräferenzen gelten für Sendungen mit
"unsubscribe": true. Das fügt auch den Präferenz-Link in die E-Mail ein.Ihr StandardFür Opt-in-Regeln (zum Beispiel Frankreich) senden Sie
"track_opens": falseund"track_clicks": false, bis der Empfänger es erlaubt hat, und lesen die Präferenz vor dem Senden mit Get Many.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDer API key hat nicht den Scope dieses Befehls (`privacy:read` zum Lesen, `privacy:write` zum Ändern).
- CMD
INVALID_ARGSEin Argument ist ungültig: fehlende oder fehlerhafte `email`, mehr als 100 `emails`, `track_opens`, das nicht `true`/`false` ist, limit außerhalb des Bereichs…
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.