Ejemplos de Postman

Resumen

Esta guía proporciona instrucciones paso a paso para autenticarse y crear campañas mediante la API de ExoClick usando Postman. Todos los ejemplos especifican el tipo de solicitud, los encabezados y el formato del cuerpo requeridos para cada 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 utilizado para todas las solicitudes posteriores.

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

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

Encabezados:

Content-Type: application/json

Cuerpo (JSON sin procesar):

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

Inicio de sesión con token de API

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

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

Encabezados:

Content-Type: application/json

Cuerpo (JSON sin procesar):

{
  "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. Los banners estándar requieren un id_library_url.

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

Encabezados:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Cuerpo (JSON sin procesar):

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

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

2

Subir imagen (Biblioteca)

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

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

Encabezados:

Authorization: Bearer YOUR_TOKEN

Cuerpo (form-data):

Clave	Tipo	Valor
file	Archivo	Selecciona tu archivo de imagen (300x250)
type	Texto	image

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

3

Crear estructura de campaña

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

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

Encabezados:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Cuerpo (JSON sin procesar):

{
  "name": "Banner 300x250 de producción",
  "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" (por ejemplo, 8140060).

4

Añadir la variante

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

Tipo de solicitud: POST URL: https://api.exoclick.com/v2/campaigns/8140060/variation (Reemplaza 8140060 con el ID real de tu campaña del Paso 3)

Encabezados:

Authorization: Bearer YOUR_TOKEN

Cuerpo (form-data):

Clave	Tipo	Valor
id_library_url	Texto	6512406 (del Paso 1)
id_library_file	Texto	6884966 (del Paso 2)
active	Texto	1

Todos los IDs devueltos en cada paso deben guardarse y usarse en solicitudes posteriores. Recuerda reemplazar YOUR_TOKEN, las rutas de archivo y los IDs con tus valores reales.