Einzelne Event-Abschlüsse abfragen
Diese API gibt Events für jeweils einen CRM-Datensatz zurück. Sie können den Datensatz auswählen, indem Sie denobjectType angeben und entweder den objectId- oder objectProperty-Abfrageparameter hinzufügen.
Nach Objekt-ID auswählen
Um einen Datensatz anhand seiner ID anzugeben, fügen Sie denobjectId-Abfrageparameter hinzu. Um beispielsweise einen Kontaktdatensatz mit der ID 2832 anzugeben, müssen Sie die folgende GET-Anfrage vornehmen:
/events/v3/events/?objectType=contact&objectId=224834
Nach Objekteigenschaft auswählen
Um einen Datensatz anhand einer eindeutigen Eigenschaft anstelle der Kontakt-ID anzugeben, fügen Sie denobjectProperty-Parameter hinzu. Verweisen Sie auf die Eigenschaft, indem Sie den Eigenschaftsnamen und den Wert im folgendem Format einschließen:
objectProperty.{propname}={propvalue}
Um beispielsweise einen Kontakt anhand seiner E-Mail-Adresse anzugeben, müssen Sie die folgende GET-Anfrage vornehmen:
/events/v3/events/?objectType=contact&objectProperty.email=user12@dev.com
Abfragen von und Filtern nach Event-Typen
Beim Abfragen der Events, die einem bestimmten CRM-Objekt zugeordnet sind, umfasst die Antwort alle Event-Typen, einschließlich benutzerdefinierter verhaltensorientierter Events. Um nur Event-Abschlüsse zurückzugeben für einen bestimmten Event-Typ, können Sie eineneventType-Parameter gefolgt vom Event-Namen einschließen. Um eine Liste aller verfügbaren Event-Typen abzurufen, können Sie eine GET-Anfrage an /events/v3/events/event-types durchführen. Die Antwort gibt alle Event-Typen in Ihrem Account zurück. Sie können dann einen dieser Event-Namen als Abfrageparameter in einer GET-Anfrage den Endpunkt /events/v3/events verwenden.
Zum Beispiel:
/events/v3/events/eventType={EVENT_NAME}&objectType=contact&objectId=224834