Exemplos de carteiro

Visão geral

Este guia fornece instruções passo a passo para autenticar e criar campanhas por meio da API da ExoClick usando o Postman. Todos os exemplos especificam o tipo de solicitação, os cabeçalhos e o formato do corpo necessários para cada 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

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

Cabeçalhos:

Content-Type: application/json

Corpo (JSON bruto):

{
  "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).

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

Cabeçalhos:

Content-Type: application/json

Corpo (JSON bruto):

{
  "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 seu URL de destino. Os banners padrão requerem um id_library_url.

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

Cabeçalhos:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Corpo (JSON bruto):

{
  "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.

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

Cabeçalhos:

Authorization: Bearer YOUR_TOKEN

Corpo (dados do formulário):

Chave	Tipo	Valor
ficheiro	Ficheiro	Selecione o seu ficheiro de imagem (300x250)
tipo	Texto	imagem

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.

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

Cabeçalhos:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Corpo (JSON bruto):

{
  "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: 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).

Tipo de pedido: POST URL: https://api.exoclick.com/v2/campaigns/8140060/variation (Substitua 8140060 pelo seu ID de campanha atual do passo 3)

Cabeçalhos:

Authorization: Bearer YOUR_TOKEN

Corpo (dados do formulário):

Chave	Tipo	Valor
id_library_url	Texto	6512406 (do passo 1)
id_file_library	Texto	6884966 (do passo 2)
ativo	Texto	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.