Postman-Beispiele

Überblick

Dieser Leitfaden bietet Schritt-für-Schritt-Anweisungen zum Authentifizieren und Erstellen von Kampagnen über die ExoClick-API mit Postman. Alle Beispiele geben den erforderlichen Request-Typ, die Header und das Body-Format für jeden Endpunkt an.

Authentifizierung (Login)

Du kannst dich mit deinen Kontodaten oder einem permanenten API-Token authentifizieren. Beide geben ein temporäres Bearer-Token zurück, das für alle nachfolgenden Anfragen verwendet wird.

Login mit Benutzername und Passwort

Request-Typ: POST URL: https://api.exoclick.com/v2/login

Header:

Content-Type: application/json

Body (rohes JSON):

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD"
}

Login mit API-Token

Ablauf zur Erstellung einer 300x250-Bannerkampagne

Befolge diese Schritte exakt in der angegebenen Reihenfolge. Beachte den Übergang von JSON zu Form-Data in den letzten Schritten.

1

Landingpage-URL erstellen (Bibliothek)

Registriert deine Ziel-URL. Standard-Banner benötigen eine id_library_url.

Request-Typ: POST URL: https://api.exoclick.com/v2/library/url

Header:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Body (rohes JSON):

{
  "url": "https://your-landing-page.com"
}

Ergebnis: Speichere die zurückgegebene "id" (z. B., 6512406).

2

Bild hochladen (Bibliothek)

Registriert dein Creative-Asset. Das Bild muss exakt 300x250 groß sein.

Request-Typ: POST URL: https://api.exoclick.com/v2/library/file

Header:

Authorization: Bearer YOUR_TOKEN

Body (Form-Data):

Schlüssel	Typ	Wert
file	Datei	Wähle deine Bilddatei aus (300x250)
type	Text	image

Ergebnis: Speichere die zurückgegebene "id" (z. B., 6884966).

3

Kampagnen-Gerüst erstellen

Legt Targeting, Budget und die img_banner Vorlage fest.

Request-Typ: POST URL: https://api.exoclick.com/v2/campaigns

Header:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Body (rohes JSON):

{
  "name": "Banner 300x250 Production",
  "status": 0,
  "advertiser_ad_type": 0,
  "media_storage_template": "img_banner",
  "size": "300x250",
  "categories": {
    "type": "targeted",
    "elements": [97, 98, 99]
  },
  "countries": {
    "type": "targeted",
    "elements": [
      {
        "country": "USA",
        "regions": [0]
      }
    ]
  },
  "pricing": {
    "model": 4,
    "price": 300
  },
  "start_date": "2026-03-02",
  "daily_limit_type": 1,
  "max_daily_budget": 2000,
  "budget_delivery_mode": 1,
  "run_on_responsive_zones": 1
}

Ergebnis: Speichere die zurückgegebene "id" (z. B., 8140060).

4

Variante hinzufügen

Verknüpft die URL (Schritt 1) und das Bild (Schritt 2) mit der Kampagne (Schritt 3).

Request-Typ: POST URL: https://api.exoclick.com/v2/campaigns/8140060/variation (Ersetze 8140060 durch deine tatsächliche Kampagnen-ID aus Schritt 3)

Header:

Authorization: Bearer YOUR_TOKEN

Body (Form-Data):

Schlüssel	Typ	Wert
id_library_url	Text	6512406 (aus Schritt 1)
id_library_file	Text	6884966 (aus Schritt 2)
active	Text	1

Alle IDs, die in jedem Schritt zurückgegeben werden, müssen gespeichert und in nachfolgenden Anfragen verwendet werden. Denke daran, YOUR_TOKEN, Dateipfade und IDs durch deine tatsächlichen Werte zu ersetzen.