API de Marketing

🔐 Autenticação

Todas as requisições devem incluir sua API Key no header Authorization.

curl -X GET "https://marketing-api.devskin.com/api/campaigns" \
  -H "Authorization: Bearer dmk_sua_api_key_aqui" \
  -H "Content-Type: application/json"

⚠️ Códigos de Erro

🔗 Webhooks

Receba notificações em tempo real quando eventos importantes acontecerem na sua conta.

Configurando Webhooks

1. Acesse Configurações → API → Webhooks
2. Clique em "Adicionar Webhook"
3. Informe a URL do seu endpoint
4. Selecione os eventos que deseja receber

Verificando a Assinatura

Cada webhook inclui uma assinatura no header para validar a autenticidade:

// Header: X-Webhook-Signature: t=1234567890,v1=assinatura_hex

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const [timestamp, hash] = signature.split(',').map(p => p.split('=')[1]);
  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${timestamp}.${JSON.stringify(payload)}`)
    .digest('hex');
  return hash === expected;
}

📥 Webhook de Leads (LP)

Receba leads automaticamente quando alguém preencher um formulário na sua Landing Page.

Exemplo de Payload

{
  "event": "lead.created",
  "timestamp": 1706918400,
  "data": {
    "lead": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "João Silva",
      "email": "[email protected]",
      "phone": "+5511999999999",
      "form_data": {
        "empresa": "Empresa ABC",
        "cargo": "Diretor",
        "mensagem": "Tenho interesse no produto"
      },
      "utm_source": "google",
      "utm_medium": "cpc",
      "utm_campaign": "black-friday",
      "created_at": "2024-02-03T10:00:00Z"
    },
    "landing_page": {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Black Friday 2024",
      "slug": "black-friday-2024",
      "url": "https://promo.empresa.com/black-friday"
    }
  }
}

Integrando com seu CRM

// Exemplo: Recebendo leads e enviando para seu CRM
app.post('/webhook/marketing-leads', async (req, res) => {
  const { event, data } = req.body;

  if (event === 'lead.created') {
    // Enviar para seu CRM
    await crm.createLead({
      name: data.name,
      email: data.email,
      phone: data.phone,
      source: `LP: ${data.landing_page_name}`,
      customFields: data.custom_fields
    });

    // Enviar email de boas-vindas
    await emailService.send({
      to: data.email,
      template: 'welcome',
      data: { name: data.name }
    });
  }

  res.status(200).json({ received: true });
});

📋 Eventos Disponíveis

👥 Leads

Query Parameters

curl -X GET "https://marketing-api.devskin.com/api/leads?landing_page_id=lp_xyz789&limit=10" \
  -H "Authorization: Bearer dmk_sua_api_key"

Body Parameters

curl -X POST "https://marketing-api.devskin.com/api/leads" \
  -H "Authorization: Bearer dmk_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "name": "Maria Silva",
    "phone": "+5511988887777",
    "source": "manual_import",
    "custom_fields": {
      "company": "Empresa XYZ"
    }
  }'

📊 Campaigns

// Response
{
  "success": true,
  "data": [
    {
      "id": "camp_abc123",
      "name": "Black Friday 2024",
      "platform": "google_ads",
      "status": "active",
      "budget_daily": 500.00,
      "metrics": {
        "impressions": 125000,
        "clicks": 3200,
        "conversions": 89,
        "spend": 4500.00,
        "ctr": 2.56,
        "cpc": 1.41
      },
      "created_at": "2024-01-15T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45
  }
}

Query Parameters

🔑 Keywords

// Response
{
  "success": true,
  "data": [
    {
      "id": "kw_abc123",
      "keyword": "marketing digital",
      "search_volume": 12500,
      "difficulty": 67,
      "current_position": 4,
      "previous_position": 7,
      "trend": "up",
      "cpc": 2.45
    }
  ]
}

✨ Geração de Conteúdo com IA

Body Parameters

curl -X POST "https://marketing-api.devskin.com/api/content/generate" \
  -H "Authorization: Bearer dmk_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "social_post",
    "topic": "Lançamento de produto",
    "keywords": ["inovação", "tecnologia"],
    "tone": "persuasive",
    "language": "pt"
  }'

📄 Landing Pages

curl -X GET "https://marketing-api.devskin.com/api/landing-pages/lp_xyz789/leads?limit=50" \
  -H "Authorization: Bearer dmk_sua_api_key"

// Response
{
  "success": true,
  "data": {
    "landing_page": {
      "id": "lp_xyz789",
      "name": "Black Friday 2024",
      "url": "https://promo.empresa.com/black-friday",
      "total_leads": 234,
      "conversion_rate": 4.5
    },
    "leads": [
      {
        "id": "lead_abc123",
        "name": "João Silva",
        "email": "[email protected]",
        "phone": "+5511999999999",
        "created_at": "2024-02-03T10:00:00Z"
      }
    ]
  }
}

⏱️ Rate Limits

Headers de rate limit incluídos em todas as respostas:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1706918460