PEIQ Knowledge Base

Abfrage geänderter Beilagen

Änderungen an Beilagen werden als Events in der Datenbank gespeichert. Durch die Abfrage dieser Events können geänderte Beilagen ermittelt werden.

Funktionalitäten der Abfrage geänderter Beilagen

  • Abfrage von Auftragsänderungen

  • Abfrage von Beilagenänderungen

Inhaltsverzeichnis

Allgemeine Beschreibung

Änderungen an einem Auftrag oder an Beilagen werden als Event in der Tabelle “dauftrag_changed_event” gespeichert. Jedes Event erhält eine fortlaufende ChangeID und wird zusammen mit der CID (= Cluster ID) des “DAuftrag” gespeichert.

In der Tabelle “dauftrag_changed_event” werden auch Änderungen an Anzeigen und den übergeordneten Aufträgen gespeichert. Zur Unterscheidung von Beilagen- und Anzeigen-Events wird der Auftragstyp (“BE” = Beilage, “AN” = Anzeige) an jedem Event in der Tabelle gespeichert.

Bei der Abfrage geänderter Beilagen werden nur Events mit Auftragstyp “BE” berücksichtigt. Die Abfrage erfolgt über den Endpunkt “supplements/events”.

Aufruf: {{baseURL}}/adapi/v1/ads/events

image-20240919-132020.png
Ad API Endpunkt “supplements/events”

Parameter

  • eventName: Entscheidet über die Art der Abfrage. Folgende Werte sind möglich:

    • changed: Alle Änderungen an Aufträgen und Beilagen werden berücksichtigt

  • offset: Gibt die letzte “ChangeID” an. Alle nachfolgenden “ChangeIDs” in der Tabelle “dauftrag_production_event” werden beim nächsten Aufruf berücksichtigt. Zurückgegeben wird die im Aufruf höchste berücksichtigte “ChangeID”. Der Wert ist beim ersten Aufruf leer. Bei weiteren Aufrufen wird der Wert des jeweils vorherigen Aufrufs zurückgegeben.

  • limit: Gibt an, wie viele Datensätze bei jedem Aufruf ausgegeben werden sollen.

Rückgabewerte

  • offset: Die im Aufruf höchste berücksichtigte “ChangeID”.

  • data: Auftrags- und Beilagen-Nummern ab dem angegebenen offset. Es werden maximal so viele Datensätze ausgegeben, wie im Limit definiert sind.

 

Mit den bei “/supplements/events” erhaltenen Nummern können die Daten der zugehörigen Elemente abgefragt werden.

Verwandte Seiten

Nur für PEIQ-Mitarbeiter:

tbd