Documentação da API - Laenad | API da Plataforma de Marketing de Afiliados

Introdução

Bem-vindo à documentação da API da Laenad. A nossa API REST permite-lhe aceder programaticamente aos seus dados de afiliado, gerir ofertas e integrar soluções personalizadas com a sua plataforma.

URL Base: https://api.laenad.com/v1

Todas as respostas da API são devolvidas em formato JSON. A API utiliza códigos e verbos HTTP padrão.

Autenticação

Todos os pedidos à API exigem autenticação através de uma chave de API. Inclua a sua chave de API no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Pode gerar chaves de API a partir do painel da sua conta. Cada chave tem permissões específicas e pode ser revogada a qualquer momento.

POST /auth/generate-key

Gera uma nova chave de API para a sua conta

Limites de Pedidos

Para garantir uma utilização equitativa, a API tem os seguintes limites de pedidos:

Plano Padrão: 1.000 pedidos por hora
Plano Premium: 5.000 pedidos por hora
Plano Enterprise: Pedidos ilimitados

Os cabeçalhos de limite de pedidos estão incluídos em todas as respostas da API:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1640995200

Ofertas

Obtenha e filtre as ofertas disponíveis na plataforma.

GET /offers

Obtém todas as ofertas disponíveis para a sua conta

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`page`	integer	Opcional	Número da página para paginação (predefinição: 1)
`limit`	integer	Opcional	Itens por página (predefinição: 20, máximo: 100)
`category`	string	Opcional	Filtrar por categoria de oferta
`country`	string	Opcional	Filtrar por código de país (ISO 3166-1 alpha-2)

Exemplo de Resposta:

{
  "success": true,
  "data": [
    {
      "id": 12345,
      "name": "Premium VPN Offer",
      "category": "Software",
      "payout": 15.50,
      "currency": "USD",
      "countries": ["US", "CA", "GB", "AU"],
      "platform": "Android",
      "tracking_link": "https://track.laenad.com/?o=12345&a={affiliate_id}",
      "status": "active"
    }
  ],
  "pagination": {
    "total": 245,
    "page": 1,
    "pages": 13
  }
}

GET /offers/{id}

Obtém informações detalhadas sobre uma oferta específica

Relatórios

Aceda a dados de relatórios abrangentes sobre o seu desempenho como afiliado.

GET /reports/statistics

Obtém um resumo de estatísticas para um intervalo de datas

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`start_date`	string	Obrigatório	Data de início (formato AAAA-MM-DD)
`end_date`	string	Obrigatório	Data de fim (formato AAAA-MM-DD)
`offer_id`	integer	Opcional	Filtrar por ID de oferta específica
`breakdown`	string	Opcional	Detalhe por: dia, oferta, país, dispositivo

Exemplo de Resposta:

{
  "success": true,
  "data": {
    "clicks": 15420,
    "conversions": 423,
    "revenue": 6565.50,
    "currency": "USD",
    "epc": 0.43,
    "conversion_rate": 2.74,
    "daily_breakdown": [
      {
        "date": "2026-03-27",
        "clicks": 2105,
        "conversions": 58,
        "revenue": 899.00
      }
    ]
  }
}

Conversões

Obtenha dados de conversões com todos os detalhes.

GET /conversions

Obtém a lista de conversões com filtros

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`start_date`	string	Obrigatório	Data de início (AAAA-MM-DD)
`end_date`	string	Obrigatório	Data de fim (AAAA-MM-DD)
`status`	string	Opcional	Filtrar por estado: pendente, aprovada, rejeitada
`offer_id`	integer	Opcional	Filtrar por ID de oferta

Exemplo de Resposta:

{
  "success": true,
  "data": [
    {
      "id": 987654,
      "offer_id": 12345,
      "offer_name": "Premium VPN Offer",
      "conversion_time": "2026-03-27 14:32:15",
      "payout": 15.50,
      "currency": "USD",
      "status": "approved",
      "country": "US",
      "device": "mobile",
      "ip": "192.168.1.1"
    }
  ],
  "pagination": {
    "total": 423,
    "page": 1,
    "pages": 22
  }
}

Postbacks

Configure e gere URLs de postback para notificações de conversões em tempo real.

POST /postbacks/create

Cria um novo URL de postback

Corpo do Pedido

Parâmetro	Tipo	Obrigatório	Descrição
`url`	string	Obrigatório	O seu endpoint de URL de postback
`event_type`	string	Obrigatório	Tipo de evento: conversão, clique, lead
`offer_id`	integer	Opcional	Limitar a um ID de oferta específico
`secret`	string	Opcional	Chave secreta para validação

Parâmetros de Postback Disponíveis

O seu URL de postback pode incluir os seguintes parâmetros:

Parâmetro	Descrição
`{conversion_id}`	Identificador único da conversão
`{offer_id}`	ID da oferta
`{payout}`	Valor do pagamento da conversão
`{currency}`	Moeda do pagamento
`{country}`	Código do país do utilizador
`{ip}`	Endereço IP do utilizador
`{status}`	Estado da conversão
`{datetime}`	Data e hora da conversão
`{external_id}`	O seu ID de transação externo

Exemplo de URL de Postback:

https://yoursite.com/postback?
conversion_id={conversion_id}&
offer_id={offer_id}&
payout={payout}&
country={country}&
status={status}&
datetime={datetime}

Ajuda e Suporte

Se precisar de ajuda para integrar com a API ou encontrar algum problema, a nossa equipa de suporte está aqui para o ajudar.

Canais de Suporte

E-mail: api@laenad.com
QQ: 8422800
WeChat: laenad
Telegram: @laenadcom

Recursos

SDKs e Bibliotecas

SDKs oficiais estão disponíveis para as linguagens de programação mais populares:

Python SDK
PHP SDK
JavaScript/Node.js SDK
Java SDK