Documentação ClicAven
Tudo o que precisa para começar com o ClicAven.
Índice
1. Introdução
ClicAven é um serviço de encurtamento de URLs alojado em França 🇫🇷, concebido para equipas de marketing e programadores. Permite:
- Transformar qualquer URL longo num link curto partilhável
- Rastrear o número de cliques em tempo real
- Automatizar a criação de links via API REST
- Gerir os seus links a partir de um dashboard simples e elegante
O ClicAven é conforme ao RGPD. Os seus dados nunca saem da Europa e nunca são vendidos a terceiros.
2. Criar uma conta
- Aceda a clicaven.com/register
- Introduza o seu endereço de email e uma palavra-passe
- Clique em Criar a minha conta
- Está ligado, o seu plano Free está imediatamente ativo
Não é necessário cartão de crédito para o plano Free. Pode fazer upgrade a partir da sua secção Faturação.
3. Encurtar um link (dashboard)
- Inicie sessão e vá ao Dashboard
- Cole o seu URL longo no campo Encurtar um URL
- Clique em Encurtar
- O seu link curto aparece imediatamente na lista
- Copie-o com um clique usando o botão Copiar
4. Encurtar um link via API
Consulte a Referência API completa para todos os endpoints.
Em resumo, dois passos:
Passo 1 — Criar uma chave API
curl -s -X POST https://clicaven.com/api/links \
-H "Authorization: Bearer ca_votre_cle_api" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/url-tres-longue"}'
Resposta:
{
"id": 42,
"short_code": "aB3xYz",
"short_url": "https://clicaven.com/aB3xYz",
"original_url": "https://example.com/url-tres-longue",
"clicks": 0,
"created_at": "2026-04-18T12:00:00+00:00"
}
5. Rastrear cliques
Cada acesso a um link curto é contabilizado automaticamente. Pode rastrear os cliques:
- Dashboard — A coluna Cliques atualiza-se em tempo real
- API — O endpoint
GET /api/links/{id}devolve o contador de cliques
Os cliques repetidos do mesmo IP podem ser deduplicados para prevenir abusos.
6. Planos e quotas
| Plano | Links / mês | API | Slugs personalizados | Códigos QR | Preço |
|---|---|---|---|---|---|
| Free | 50 | Sim | Gratuito | ||
| Pro | 1 000 | Sim | Sim | Sim | Ver preços |
| Business | 10 000 | Sim | Sim | Sim | Ver preços |
| Scale | 100 000 | Sim | Sim | Sim | Ver preços |
* Em caso de superação da quota, a criação de novos links fica temporariamente bloqueada até ao início do mês seguinte.
7. FAQ rápida
- Os meus links são permanentes?
- Sim, enquanto a sua conta estiver ativa. Pode eliminar um link a qualquer momento.
- Posso personalizar o código curto?
- Sim, a partir do plano Pro. Pode escolher um slug personalizado de 3 a 60 caracteres (letras, números e hífenes).
- O que acontece se cancelar a subscrição?
- Regressa ao plano Free. Os seus links existentes permanecem ativos mas não pode criar mais além do limite Free.
- Como elimino a minha conta?
- Contacte-nos através da nossa página de contacto. Todos os seus dados serão eliminados em 30 dias.
Precisa de ajuda? Contacte-nos ou consulte a Referência API.