Umstellung von IDs auf Objekt-IDs

Wir haben alle Entitäten auf Objekt-IDs umgestellt. Das verbessert die Lesbarkeit, ermöglicht die unabhängige Erzeugung von IDs in verschiedenen Diensten und stellt Eindeutigkeit auch in großem Maßstab sicher.

Was sind Objekt-IDs?

Objekt-IDs sind eindeutige Kennungen mit einem Präfix, das den Entitätstyp anzeigt. Anstelle einer generischen ID wie 12345 oder einer UUID erhalten Sie etwas wie:

em_48klx31D1jqAfDcG53R8y1j1XbP

Das Präfix em_ zeigt Ihnen sofort, dass es sich um eine E-Mail-Entität handelt.

Vorteile

• Lesbar – Entitätstyp auf einen Blick erkennbar
• Eindeutig – Keine Kollisionen zwischen Diensten
• Sortierbar – IDs sind nach Erstellungszeit sortierbar
• Skalierbar – Unabhängige Erzeugung ohne Abstimmung über die Datenbank

Entitätspräfixe

• Kontaktlisten (Audiences) – aud_
• Kampagnen – cmp_
• Klicks – click_
• Kontakte – con_
• Zugangsdaten (API-Schlüssel) – key_
• Eigene Felder – cf_
• Zustellungen – del_
• E-Mails – em_
• Events – evt_
• Dateien – file_
• Links – link_
• Ladevorgänge – load_
• E-Mails in der Warteschlange – que_
• Domains – dom_
• Abonnenten – sub_
• Sperrungen (Suppressions) – sup_
• Abmeldungen – uns_
• Webhook-Anfragen – whr_
• Webhooks – wh_

Migration abgeschlossen

Wir haben über 1,5 Milliarden Datensätze auf das neue Objekt-ID-Format migriert. Alle Antworten der API v2 liefern für die oben aufgeführten Entitäten jetzt Objekt-IDs.