Ejemplos de cURL

Resumen

Esta guía proporciona comandos cURL listos para usar para autenticarse y crear campañas a través de la API de ExoClick. Todos los ejemplos usan formatos estándar JSON o Form-Data, según los requisitos del endpoint.

Autenticación (Inicio de sesión)

Puedes autenticarte usando las credenciales de tu cuenta o un Token de API permanente. Ambos devuelven un Bearer Token temporal que se usa para todas las solicitudes posteriores.

Iniciar sesión con nombre de usuario y contraseña

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

Iniciar sesión con Token de API

Usa esto si generaste un token en tu Panel de ExoClick (Perfil > Tokens de API).

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

Flujo de creación de campaña Banner 300x250

Sigue estos pasos en el orden exacto. Ten en cuenta la transición de JSON a Form-Data en los pasos finales.

1

Crear URL de página de destino (Biblioteca)

Registra tu URL de destino.

Formato: 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"
     }'

Resultado: Guarda el "id" devuelto (por ejemplo, 6512406).

2

Subir imagen (Biblioteca)

Registra tu recurso creativo. La imagen debe ser exactamente 300x250.

Formato: 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"

Resultado: Guarda el "id" devuelto (por ejemplo, 6884966).

3

Crear estructura de campaña

Define la segmentación, el presupuesto y la img_banner plantilla.

Formato: 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
}'

Resultado: Guarda el "id" devuelto (por ejemplo, 8140060).

4

Añadir la variación

Vincula la URL (Paso 1) y la imagen (Paso 2) a la campaña (Paso 3).

Formato: 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"

Todos los IDs devueltos en cada paso deben guardarse y utilizarse en las solicitudes posteriores. Recuerda reemplazar YOUR_TOKEN , las rutas de archivos y los IDs por tus valores reales.