Ejemplos de carteros

Visión general

Esta guía proporciona instrucciones paso a paso para autenticar y crear campañas a través de la API de ExoClick utilizando Postman. Todos los ejemplos especifican el tipo de solicitud, las cabeceras y el formato del cuerpo necesarios para cada punto final.

Autenticación (inicio de sesión)

Puede autenticarse utilizando las credenciales de su cuenta o un token de API permanente. Ambos devuelven un token de portador temporal que se utiliza para todas las solicitudes posteriores.

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

Tipo de solicitud: POST URL: https://api.exoclick.com/v2/login

Cabeceras:

Content-Type: application/json

Body (raw JSON):

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

B - Inicio de sesión con token de API

Utilícelo si ha generado un token en el panel de control de ExoClick (Perfil > Tokens de API).

Tipo de solicitud: POST URL: https://api.exoclick.com/v2/login

Cabeceras:

Content-Type: application/json

Body (raw JSON):

{
  "api_token": "YOUR_API_TOKEN"
}

flujo de creación de campañas de banners de 300x250

Siga estos pasos en el orden exacto. Tenga en cuenta la transición de JSON a Form-Data en los últimos pasos.

Paso 1: Crear URL de página de destino (Biblioteca)

Registra la URL de destino. Los banners estándar requieren un id_library_url.

Tipo de solicitud: POST URL: https://api.exoclick.com/v2/library/url

Cabeceras:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Body (raw JSON):

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

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

Paso 2: Cargar imagen (Biblioteca)

Registra tu activo creativo. La imagen debe ser exactamente de 300x250.

Tipo de solicitud: POST URL: https://api.exoclick.com/v2/library/file

Cabeceras:

Authorization: Bearer YOUR_TOKEN

Body (form-data):

Clave	Tipo	Valor
"archivo	Archivo	Seleccione su archivo de imagen (300x250)
tipo	Texto	imagen

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

Paso 3: Crear una campaña

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

Tipo de solicitud: POST URL: https://api.exoclick.com/v2/campaigns

Cabeceras:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Body (raw 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
}

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

Paso 4: Añadir la variación

Vincula la URL (Paso 1) y la Imagen (Paso 2) a la Campaña (Paso 3).

Tipo de solicitud: POST URL: https://api.exoclick.com/v2/campaigns/8140060/variation (Sustituya 8140060 por su ID de campaña real del paso 3)

Cabeceras:

Authorization: Bearer YOUR_TOKEN

Body (form-data):

Clave	Tipo	Valor
id_library_url	Texto	6512406 (del Paso 1)
id_archivo_de_biblioteca	Texto	6884966 (del paso 2)
activo	Texto	1

Todos los IDs devueltos en cada paso deben ser guardados y utilizados en peticiones posteriores. Recuerde sustituir YOUR_TOKEN, las rutas de los archivos y los ID por sus valores reales.