Postbote Beispiele

Übersicht

Dieser Leitfaden enthält Schritt-für-Schritt-Anweisungen für die Authentifizierung und Erstellung von Kampagnen über die ExoClick-API mit Postman. Alle Beispiele geben den erforderlichen Anfragetyp, die Kopfzeilen und das Format des Textkörpers für jeden Endpunkt an.

Authentifizierung (Anmeldung)

Sie können sich mit Ihren Kontoanmeldedaten oder einem permanenten API-Token authentifizieren. Beide geben ein temporäres Bearer Token zurück, das für alle nachfolgenden Anfragen verwendet wird.

A - Anmeldung mit Benutzername und Passwort

Anfragetyp: POST URL: https://api.exoclick.com/v2/login

Kopfzeilen:

Content-Type: application/json

Körper (rohes JSON):

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

B - Anmeldung mit API-Token

Verwenden Sie dies, wenn Sie ein Token in Ihrem ExoClick Dashboard (Profil > API Tokens) generiert haben.

Anfragetyp: POST URL: https://api.exoclick.com/v2/login

Kopfzeilen:

Content-Type: application/json

Körper (rohes JSON):

{
  "api_token": "YOUR_API_TOKEN"
}

300x250 Banner-Kampagnen-Erstellungsablauf

Befolgen Sie diese Schritte in genauer Reihenfolge. Beachten Sie den Übergang von JSON zu Form-Data in den letzten Schritten.

Schritt 1: Landing Page URL erstellen (Bibliothek)

Registriert Ihre Ziel-URL. Standardbanner erfordern eine id_library_url.

Anfragetyp: POST URL: https://api.exoclick.com/v2/library/url

Kopfzeilen:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Körper (rohes JSON):

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

Ergebnis: Speichern Sie die zurückgegebene "id" (z. B. "6512406").

Schritt 2: Bild hochladen (Bibliothek)

Registriert Ihr kreatives Asset. Das Bild muss genau 300x250 groß sein.

Anfragetyp: POST URL: https://api.exoclick.com/v2/library/file

Kopfzeilen:

Authorization: Bearer YOUR_TOKEN

Körper (Formulardaten):

Schlüssel	Typ	Wert
datei	Datei	Wählen Sie Ihre Bilddatei (300x250)
typ	Text	bild

Ergebnis: Speichern Sie die zurückgegebene "id" (z. B. "6884966").

Schritt 3: Kampagnen-Shell erstellen

Legt die Zielsetzung, das Budget und die Vorlage img_banner fest.

Anfragetyp: POST URL: https://api.exoclick.com/v2/campaigns

Kopfzeilen:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Körper (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: Speichern Sie die zurückgegebene "id" (z. B. "8140060").

Schritt 4: Hinzufügen der Variation

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

Anfragetyp: POST URL: https://api.exoclick.com/v2/campaigns/8140060/variation (Ersetzen Sie 8140060 durch Ihre aktuelle Kampagnen-ID aus Schritt 3)

Kopfzeilen:

Authorization: Bearer YOUR_TOKEN

Körper (Formulardaten):

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

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