Exemplos em Postman

Visão geral

Este guia fornece instruções passo a passo para autenticar e criar campanhas através da API ExoClick usando o Postman. Todos os exemplos especificam o tipo de pedido, os cabeçalhos e o formato do corpo necessários para cada endpoint.

Autenticação (Login)

Pode autenticar-se usando as credenciais da sua conta ou um API Token permanente. Ambos devolvem um Bearer Token temporário usado em todos os pedidos subsequentes.

Login 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"
}

Login com API Token

Fluxo de criação da campanha de banner 300x250

Siga estes passos pela ordem exata. Note a transição de JSON para Form-Data nos passos finais.

1

Criar URL da página de destino (Biblioteca)

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

2

Carregar imagem (Biblioteca)

Regista o seu criativo. A imagem tem de ter exatamente 300x250.

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

Cabeçalhos:

Authorization: Bearer YOUR_TOKEN

Corpo (form-data):

Chave	Tipo	Valor
file	Ficheiro	Selecione o seu ficheiro de imagem (300x250)
type	Texto	image

Resultado: Guarde o valor devolvido "id" (por exemplo, 6884966).

3

Criar estrutura da campanha

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

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 Produção",
  "status": 0,
  "advertiser_ad_type": 0,
  "media_storage_template": "img_banner",
  "size": "300x250",
  "categories": {
    "type": "direcionado",
    "elements": [97, 98, 99]
  },
  "countries": {
    "type": "direcionado",
    "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: Guarde o valor devolvido "id" (por exemplo, 8140060).

4

Adicionar a variação

Liga a 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 ID real da sua campanha do Passo 3)

Cabeçalhos:

Authorization: Bearer YOUR_TOKEN

Corpo (form-data):

Chave	Tipo	Valor
id_library_url	Texto	6512406 (do Passo 1)
id_library_file	Texto	6884966 (do Passo 2)
ativo	Texto	1

Todos os IDs devolvidos em cada passo devem ser guardados e utilizados nos pedidos subsequentes. Lembre-se de substituir YOUR_TOKEN, os caminhos dos ficheiros e os IDs pelos seus valores reais.