Skip to main content

Admedia API (V6) - GET (Read)

Abfrage generierter Werbemittel über die V6 REST-API

Um eine einfache und effiziente Verwaltung der generierten Werbemittel zu gewährleisten, stellt die V6 REST-API eine Abfragefunktion zur Verfügung. Mit dieser Funktion können Nutzer relevante Daten zu den Werbemitteln und den zugehörigen Trackinglinks abrufen.

Endpoint

Für Admins: <https://SUBDOMAIN.de/ws/V6/admin/JSON/Admedia>

Erforderliche Parameter:

  • campaign_id: ID der betreffenden Kampagne (Pflichtfeld)

  • project_id: ID des betreffenden Projekts (Optional)

Beispielaufruf mit cURL

curl -X GET -H "Content-Type: application/json" -H "X-Network-ID: -1" -H "X-Auth-Token: ADMIN_APIUSER_TOKEN" -H "X-Auth-ID: ADMIN_APIUSER_LOGIN_ID" <https://DOMAIN/ws/V6/admin/JSON/Admedia?campaign_id=1&project_id=50001>

Erwartete Antwort

Nach erfolgreichem Aufruf gibt die API die folgenden Informationen zu den Werbemitteln im JSON-Format zurück:

  • id: ID des Werbemittels (Integer)

  • title: Titel des Werbemittels (String)

  • campaign_id: ID der zugeordneten Kampagne (Integer)

  • project_id: ID des zugeordneten Projekts (Integer, falls angegeben)

  • clicklink: Clicklink des Werbemittels (String)

  • viewlink: Viewlink des Werbemittels (String)

  • adcode: Javascriptcode/HTML-Code des Trackinglinks (String)

Fehlerbehandlung

Bei fehlendem oder ungültigem campaign_id wird ein entsprechender Fehler zurückgegeben.

Bei nicht vorhandenen Daten für die angegebenen Parameter wird ein leerer Datensatz zurückgegeben.