Exemples cURL

Vue d'ensemble

Ce guide fournit des commandes cURL prêtes à l'emploi pour s'authentifier et créer des campagnes via l'API ExoClick. Tous les exemples utilisent les formats JSON standard ou Form-Data selon les exigences du point de terminaison.

Authentification (Connexion)

Vous pouvez vous authentifier à l'aide des identifiants de votre compte ou d'un jeton API permanent. Les deux renvoient un jeton Bearer temporaire utilisé pour toutes les requêtes suivantes.

Connexion avec nom d'utilisateur et mot de passe

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "username": "YOUR_USERNAME",
       "password": "YOUR_PASSWORD"
     }'

Connexion avec un jeton API

Flux de création de campagne bannière 300x250

Suivez ces étapes dans l'ordre exact. Notez la transition de JSON à Form-Data dans les dernières étapes.

1

Créer l'URL de la page de destination (Bibliothèque)

Enregistre votre URL de destination.

Format : JSON

curl -X POST "https://api.exoclick.com/v2/library/url" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://your-landing-page.com"
     }'

Résultat : Enregistrez le "id" (par ex., 6512406).

2

Téléverser l'image (Bibliothèque)

Enregistre votre ressource créative. L'image doit être exactement 300x250.

Format : Form-Data

curl -X POST "https://api.exoclick.com/v2/library/file" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "file=@/path/to/your/image_300x250.jpg" \
     -F "type=image"

Résultat : Enregistrez le "id" (par ex., 6884966).

3

Créer la structure de campagne

Définit le ciblage, le budget et le img_banner modèle.

Format : JSON

curl -X POST "https://api.exoclick.com/v2/campaigns" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Banner 300x250",
  "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
}'

Résultat : Enregistrez le "id" (par ex., 8140060).

4

Ajouter la variation

Lie l'URL (Étape 1) et l'image (Étape 2) à la campagne (Étape 3).

Format : Form-Data

curl -X POST "https://api.exoclick.com/v2/campaigns/8140060/variation" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "id_library_url=6512406" \
     -F "id_library_file=6884966" \
     -F "active=1"

Tous les identifiants renvoyés à chaque étape doivent être enregistrés et utilisés dans les requêtes suivantes. N'oubliez pas de remplacer YOUR_TOKEN, les chemins de fichiers et les identifiants par vos valeurs réelles.