Skip to main content

​
Bem-vindo à API do the news

O backend do the news é uma solução robusta e escalável construída sobre Cloudflare Workers, projetada para gerenciar todo o ecossistema de dados e operações do the news. Nossa API possui endpoints seguros e performáticos para newsletters, métricas de ads, engagement de usuários, CRM e muito mais.

Referrals API

Sistema completo de indicações com anti-fraude e gamificação

Streaks API

Gamificação de leitura com missões, rankings e recompensas

​
Arquitetura & Tecnologia

Nossa API foi construída com tecnologias modernas e escaláveis:
  • Runtime: Cloudflare Workers (Edge Computing)
  • Framework: Hono (Ultra-rápido e lightweight)
  • Databases: Cloudflare D1 (SQLite distribuído)
  • Cache: Cloudflare KV (Cache global)
  • ORM: Drizzle ORM (Type-safe)
  • AI: Google Gemini (Insights automáticos)
  • Monitoramento: Sentry (Error tracking)

​
Múltiplos Bancos Especializados

Nossa arquitetura utiliza bancos de dados especializados para cada domínio:
Dados principais da aplicação, métricas de ads e newsletters
Sistema de gamificação, leituras e engagement dos usuários
Gestão de relacionamento com clientes e segmentação
Formulários dinâmicos e submissions
Sistema de suporte e tickets
Tracking de aquisição de usuários
Integrações e parcerias sociais
Otimização de tracking por pixel

​
Autenticação

Rotas Protegidas: Muitos endpoints requerem autenticação JWT para acesso. Certifique-se de incluir o token de autenticação nos headers das requisições.
Todos os endpoints autenticados utilizam Bearer Token Authentication via JWT: 
Authorization: Bearer YOUR_JWT_TOKEN

​
Tipos de Endpoints

🔓 Públicos

Endpoints acessíveis sem autenticação (login, registro, webhooks)

🔒 Autenticados

Endpoints que requerem JWT token válido (dashboard, admin, exports)

​
Newsletters Suportadas

Nossa API gerencia múltiplos cadernos do ecossistema:

the news

Para começar o dia bem e informado: mais inteligente em 5 minutos

the bizness

Análises e insights sobre o mundo dos negócios

the champs

Análises, notícias e highlight do seu esporte favorito

Health Times

Tudo que você precisa saber sobre saúde de forma simples, rápida e interessante

rising

Reflexões e experiências que despertam o seu melhor. Para uma mente forte e uma vida leve

GoGet

Seu novo guia favorito! Dicas de restaurantes, bares, exposições, filmes, livros, arte, música e muito mais

the jobs

Um one-on-one com uma curadoria de conteúdos sobre carreira

the stories

Histórias de amor contadas em forma de texto

​
Recursos Principais

​
🔄 Cache Ultra-Otimizado

Sistema de cache inteligente com invalidação automática e métricas de performance em tempo real.

​
🤖 IA Integrada

Insights automáticos gerados por Google Gemini para análise de performance e recomendações.

​
📊 Métricas Multi-Plataforma

Integração completa com Facebook Ads, TikTok Ads, Google Ads e Instagram para métricas unificadas.

​
🛡️ Sistema Anti-Fraude

Detecção avançada de padrões suspeitos no programa de indicações com scoring automático.

​
⚡ Performance Edge

Distribuição global via Cloudflare Edge com latência ultra-baixa em qualquer lugar do mundo.

​
Rate Limits & Limites

Nossa API utiliza a infraestrutura do Cloudflare Workers, que oferece alta disponibilidade e escalabilidade automática.
  • Timeout por requisição: 120 segundos (2 minutos)
  • Timeout para cache: 50ms para hits de cache
  • Scheduled tasks: Executam a cada 7 horas para atualizações automáticas

​
Suporte & Status

📋 Status da API

Monitore o status em tempo real dos nossos serviços

🐛 Report de Bugs

Reporte problemas via Sentry integration
Começando: Explore nossa documentação começando pelos endpoints de Referrals ou Streaks para entender os principais recursos da API.