Saltar para o conteúdo principal

exemplos cURL

Visão geral​

Este guia fornece comandos cURL prontos a usar para autenticar e criar campanhas através da API da ExoClick. Todos os exemplos usam formatos JSON ou Form-Data padrão, dependendo dos requisitos do ponto de extremidade.

Autenticação (Login)​

Pode autenticar-se utilizando as credenciais da sua conta ou um Token de API permanente. Ambos devolvem um Token de Portador temporário utilizado para todos os pedidos subsequentes.

A - Iniciar sessão com nome de utilizador e palavra-passe​

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

B - Iniciar sessão com o Token da API​

Utilize esta opção se tiver gerado um token no seu ExoClick Dashboard (Profile > API Tokens).

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

fluxo de criação da campanha de banner 300x250​

Siga estes passos na ordem exacta. Observe a transição de JSON para Form-Data nas etapas finais.

Passo 1: Criar URL da página de destino (Biblioteca)​

Regista o 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: Guardar o "id" devolvido (por exemplo, 6512406).

Passo 2: Carregar imagem (Biblioteca)​

Regista o seu ativo criativo. A imagem deve ter exatamente 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: Guardar o "id" devolvido (por exemplo, 6884966).

Etapa 3: Criar o shell da campanha​

Define a segmentação, o orçamento e o modelo img_banner.

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: Guardar o "id" devolvido (por exemplo, 8140060).

Passo 4: Adicionar a variação​

Liga o URL (Passo 1) e a imagem (Passo 2) à campanha (Passo 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 os IDs retornados em cada etapa devem ser salvos e usados em solicitações subsequentes. Lembre-se de substituir YOUR_TOKEN, caminhos de ficheiros e IDs pelos seus valores reais.