API Curtin

1. Encurtar URL (novo endpoint)

POST /api/shorten

Cria URL curta para um link de destino. Permite reservar alias exclusivo quando autenticado.

{
  "full_url": "https://exemplo.com/campanha",
  "custom_alias": "minha-campanha"
}

Resposta:

{
  "ok": true,
  "short_url": "https://curtin.com.br/minha-campanha",
  "short_code": "minha-campanha",
  "full_url": "https://exemplo.com/campanha",
  "custom_alias": true,
  "created": true
}

2. Encurtar URL (compatibilidade)

GET /json/<url-encoded>

Mantido para integrações legadas.

3. Redirecionamento

GET /<short_code>

Redireciona ao destino e registra métricas (browser, dispositivo, idioma, origem/referrer e data).

4. Estatísticas de um link

GET /stats/<short_code>

Retorna URL curta, destino, cliques, data de criação e último acesso.

5. Dashboard agregado

GET /api/dashboard-summary

Retorna dados para a home: top links, origem dos visitantes, dispositivos e série temporal (janela de 30 dias).

6. Disponibilidade de alias

GET /api/alias-availability?alias=<valor>

Valida em tempo real se um alias pode ser reservado.

7. Meus aliases

GET /api/my-aliases

Retorna aliases exclusivos do usuário autenticado e métricas por alias.

DELETE /api/my-aliases/<short_code>

Exclui alias exclusivo do usuário autenticado e histórico de cliques desse alias.