Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Abfrage der Nummern der zuletzt geänderten Anzeigen und Aufträge

Über den Endpunkt /ads/events (Feed-orientiert) kann sich eine externe, technische Anzeigenproduktion die Auftrags- und Anzeigennummern der seit dem letzten offset (beim ersten mal ohne offset) neuen/geänderten Anzeigen und Aufträgen abrufen.

...

Mit den bei /ads/events erhaltenen Nummern können die Daten der zugehörigen Elemente abgefragt werden:

Anzeigen: GET /ads/{number}

Aufträge: GET /orders/{number}

Informationen vom zugehörigen Geschäftspartner können über GET /businesspartners/number abgefragt werden. Die Nummer des zugehörigen Geschäftspartners ist unter GET /orders/number im Element “business_partner” enthalten.

Unmittelbar nach dem Abholen der Anzeigendaten über die API liefert die technische Anzeigenproduktion mit "PUT ads/{number}" den beim Abrufen zuletzt erhaltenen Timestamp (production_timestamp) im Feld production_status_timestamp als Quittierung, sowie optional den Produktionsstatus (production_status) und eine optionale textuelle Info (production_note) zurück.

...

Zwischenzeitlich können weitere Parameter über PUT /ads/{number} gesetzt werden. So kann der “production_status” mit “production_status_timestamp” (entspricht immer dem Wert in production_timestamp bei der letzten Abholung) entsprechend auf “Produktion” gesetzt werden, wenn das Anzeigenmotiv produziert wird. Und “Fertig”, wenn die Anzeige fertig produziert und das Motiv hochgeladen ist. Weitere typische Parameter sind Update anderer Produktionsdaten zu einer Anzeige: height_booked_mm (bei variabler gebuchter Höhe), production_note (textuelle Info). Diese Felder können einzeln selektiv aktualisiert werden.

...

Der Upload eines Motivs der Anzeige erfolgt binär (octet-stream) über

PUT /ads/images/{number}

Die PDFe sind im CMYK-Farbmodell zu übermitteln.

...