Skip to main content
nossa API utiliza múltiplas configurações e variáveis de ambiente. entenda as principais configurações para integração abaixo.

configurações principais

URL base da API

autenticação

todos os endpoints autenticados requerem um header JWT:

variáveis de ambiente

JWT_SECRET
string
required
Secret usado para assinar e verificar tokens JWT
BEEHIIV_API_KEY
string
required
API key para integração com Beehiiv (newsletters)
GEMINI_API_KEY
string
required
API key do Google Gemini para insights automáticos
RESEND_API_KEY
string
required
API key do Resend para envio de emails
FACEBOOK_ACCESS_TOKEN
string
Token de acesso para Facebook Ads API
TIKTOK_ACCESS_TOKEN
string
Token de acesso para TikTok Ads API
SENTRY_AUTH_TOKEN
string
Token para integração com Sentry (monitoramento de erros)

configuração de bancos

nossa API utiliza múltiplos bancos D1 especializados:
DB
D1Database
required
Banco principal da aplicação
  • métricas de ads
  • dados de newsletters
  • configurações gerais
STREAKS
D1Database
required
Banco de gamificação
  • leituras dos usuários
  • cálculos de streak
  • missões e recompensas
CRM
D1Database
Gestão de relacionamento
  • segmentação de usuários
  • campanhas personalizadas
FORMS
D1Database
Formulários dinâmicos
  • submissions de forms
  • validações customizadas
TICKETS
D1Database
Sistema de suporte
  • tickets de usuários
  • histórico de atendimento

headers padrão

requisições autenticadas

webhooks

rate limits

nossa API utiliza Cloudflare Workers que escala automaticamente sem limites de rate fixos.
  • timeout por requisição: 120 segundos
  • timeout para cache: 50ms
  • scheduled tasks: execução a cada 7 horas

configuração de cache

nosso sistema de cache ultra-otimizado utiliza:
CACHE
KVNamespace
required
Cloudflare KV para cache distribuído
  • TTL automático
  • invalidação inteligente
  • métricas de performance

estratégias de cache

monitoramento

sentry integration

logs estruturados

todos os endpoints incluem logs estruturados:

exemplo de configuração completa

desenvolvimento local: use wrangler dev --remote para conectar com bancos reais durante desenvolvimento.