Admedia API (V6) - POST (Create)

Einleitung

Um Werbemittel nicht manuell, sondern durch einen automatisierten Prozess im easy.affiliate-System zu erstellen, stellt die easy Marketing GmbH eine Webservice-API bereit. Hierfür steht jedem User ein Authentifizierungs-Token und eine Login_id zur Verfügung. Der Authentifizierungs-Token sowie die Login_id werden dem User über das Frontend bereitgestellt.

User-ID: Wo ist die User-ID hinterlegt?

Access-Token: Wo ist der Access-Token hinterlegt?

Endpoint für Admin:

https://SUBDOMAIN.de/ws/V6/admin/JSON/Admedia

Endpoint für Advertiser:

https://SUBDOMAIN.de/ws/V6/advertiser/JSON/Admedia

---

Beispiel mit cURL

curl -X POST -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" -d "$EXAMPLE_JSON_DATA" <https://DOMAIN/ws/V6/admin/JSON/Admedia>

---

Codebeispiel

Mit der folgenden Methode können Werbemittel erstellt werden. Ein Beispielaufruf sieht folgendermaßen aus:

Headers:

Content-Type: application/json
X-Network-ID: -1
X-Auth-Token: ADMIN_APIUSER_TOKEN
X-Auth-ID: ADMIN_APIUSER_LOGIN_ID

Body:

{
    "campaign_id": 1,
    "project_ids": [50012],
    "title": "Werbemittel Titel",
    "deeplink": "https://example.de/link",
    "category_id": 5,
    "mediatype": "text",
    "linktext": "Klicken Sie hier",
    "status": 1
}

---

Variablenerläuterung

Headers

Variable	Bedeutung	Datentyp
Content-Type	Der Content-Type des Requests	String
X-NETWORKID	ID des Mandanten oder "-1"	Integer
X-AUTH-TOKEN	API-Authentifizierungs-Token des Admin Nutzers	String
X-AUTH-ID	ID des Admin Nutzers	Integer

---

Body

Parameter	Erklärung	Datentyp	Pflichtfeld
campaign_id	ID der Kampagne	Integer	Ja
project_ids	Whitelist von Projekt-IDs	JSON-ARRAY	Nein
title	Titel des Werbemittels	String	Ja
deeplink	Deeplink des Werbemittels	String	Ja
category_id	ID der Kategorie	Integer	Ja
click_tracking_getparameter	Click Tracking Parameter	String	Nein
valid_from	Gültig ab Datum	String	Nein
valid_until	Gültig bis Datum	String	Nein
mediatype	Typ des Werbemittels (z.B. text, banner)	String	Ja
linktext	Linktext (nur bei mediatype = text)	String	Ja, wenn Typ “text”
imageurl	Bild-URL (nur bei mediatype = banner)	String	Ja, wenn Typ “banner”
size_width	Breite des Banners	String	Ja, wenn Typ “banner”
size_height	Höhe des Banners	String	Ja, wenn Typ “banner”
status	Status des Werbemittels	Integer	Ja

---

Response

Nach erfolgreicher Erstellung gibt die API folgende Informationen als JSON zurück:

• Werbemittel-ID: Integer

• Werbemittel-Titel: String

• Werbemittel-Kategorie: String

• View-Link: String

• Click-Link: String

• View-Link (Shortener): String

• Click-Link (Shortener): String

• Adcode: String