> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thenewscc.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> API completa para gerenciamento de dados e operações do ecossistema

## 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.

<CardGroup cols={2}>
  <Card title="Referrals API" icon="users" href="/api-reference/referrals/introduction">
    Sistema completo de indicações com anti-fraude e gamificação
  </Card>

  <Card title="Streaks API" icon="fire" href="/api-reference/streaks/introduction">
    Gamificação de leitura com missões, rankings e recompensas
  </Card>
</CardGroup>

## 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:

<AccordionGroup>
  <Accordion title="📊 DB Principal">
    Dados principais da aplicação, métricas de ads e newsletters
  </Accordion>

  <Accordion title="🎯 STREAKS">
    Sistema de gamificação, leituras e engagement dos usuários
  </Accordion>

  <Accordion title="👥 CRM">
    Gestão de relacionamento com clientes e segmentação
  </Accordion>

  <Accordion title="📝 FORMS">
    Formulários dinâmicos e submissions
  </Accordion>

  <Accordion title="🎫 TICKETS">
    Sistema de suporte e tickets
  </Accordion>

  <Accordion title="📈 ACQUISITIONS">
    Tracking de aquisição de usuários
  </Accordion>

  <Accordion title="🔗 SOCIAL">
    Integrações e parcerias sociais
  </Accordion>

  <Accordion title="⚡ PIXEL">
    Otimização de tracking por pixel
  </Accordion>
</AccordionGroup>

## Autenticação

<Warning>
  **Rotas Protegidas**: Muitos endpoints requerem autenticação JWT para acesso. Certifique-se de incluir o token de autenticação nos headers das requisições.
</Warning>

Todos os endpoints autenticados utilizam **Bearer Token Authentication** via JWT:

```bash theme={null}
Authorization: Bearer YOUR_JWT_TOKEN
```

### Tipos de Endpoints

<CardGroup cols={2}>
  <Card title="🔓 Públicos" icon="globe">
    Endpoints acessíveis sem autenticação (login, registro, webhooks)
  </Card>

  <Card title="🔒 Autenticados" icon="lock">
    Endpoints que requerem JWT token válido (dashboard, admin, exports)
  </Card>
</CardGroup>

## Newsletters Suportadas

Nossa API gerencia múltiplos cadernos do ecossistema:

<CardGroup cols={4}>
  <Card title="the news" icon="newspaper">
    Para começar o dia bem e informado: mais inteligente em 5 minutos
  </Card>

  <Card title="the bizness" icon="briefcase">
    Análises e insights sobre o mundo dos negócios
  </Card>

  <Card title="the champs" icon="trophy">
    Análises, notícias e highlight do seu esporte favorito
  </Card>

  <Card title="Health Times" icon="heart">
    Tudo que você precisa saber sobre saúde de forma simples, rápida e interessante
  </Card>

  <Card title="rising" icon="trending-up">
    Reflexões e experiências que despertam o seu melhor. Para uma mente forte e uma vida leve
  </Card>

  <Card title="GoGet" icon="target">
    Seu novo guia favorito! Dicas de restaurantes, bares, exposições, filmes, livros, arte, música e muito mais
  </Card>

  <Card title="the jobs" icon="briefcase">
    Um one-on-one com uma curadoria de conteúdos sobre carreira
  </Card>

  <Card title="the stories" icon="heart">
    Histórias de amor contadas em forma de texto
  </Card>
</CardGroup>

## 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

<Info>
  Nossa API utiliza a infraestrutura do Cloudflare Workers, que oferece alta disponibilidade e escalabilidade automática.
</Info>

* **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

<CardGroup cols={2}>
  <Card title="📋 Status da API" icon="chart-line">
    Monitore o status em tempo real dos nossos serviços
  </Card>

  <Card title="🐛 Report de Bugs" icon="bug">
    Reporte problemas via Sentry integration
  </Card>
</CardGroup>

***

<Note>
  **Começando**: Explore nossa documentação começando pelos endpoints de [Referrals](/api-reference/referrals/introduction) ou [Streaks](/api-reference/streaks/introduction) para entender os principais recursos da API.
</Note>