> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/fr/api-publique-exoclick/api-manual-curl-examples.md).

# 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.

{% tabs %}
{% tab title="Connexion avec nom d'utilisateur et mot de passe" %}

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

{% endtab %}

{% tab title="Connexion avec un jeton API" %}
Utilisez ceci si vous avez généré un jeton dans votre tableau de bord ExoClick ([Profil](https://docs.exoclick.com/docs/general/my-profile/) > Jetons API).

```bash
curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "api_token": "YOUR_API_TOKEN"
     }'
```

{% endtab %}
{% endtabs %}

## 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.

{% stepper %}
{% step %}

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

Enregistre votre URL de destination.

**Format :** JSON

```bash
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`).
{% endstep %}

{% step %}

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

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

**Format :** Form-Data

```bash
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`).
{% endstep %}

{% step %}

### Créer la structure de campagne

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

**Format :** JSON

```bash
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`).
{% endstep %}

{% step %}

### Ajouter la variation

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

**Format :** Form-Data

```bash
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"
```

{% endstep %}
{% endstepper %}

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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/api/fr/api-publique-exoclick/api-manual-curl-examples.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.