Modelo do encurtador em Express

Gerado a partir de deploy-templates/express (dado.cloud 4c2a882).
2026-10-21 12:27:02 +00:00
commit c9e3d2ac7f
8 changed files with 1460 additions and 0 deletions
@@ -0,0 +1,81 @@
+# Encurtador de links em Express
+
+Um encurtador de links pronto para publicar na [Dado](https://dado.cloud): cole um link
+comprido, receba um endereço curto e acompanhe quantas vezes ele foi aberto.
+
+Este repositório nasceu de um modelo da Dado. Cada `git push` na branch `main` publica
+uma versão nova do seu app, sozinho.
+
+## O que tem aqui
+
+- `server.js`: o servidor — página, API (`POST/GET /api/links`) e o redirecionamento `GET /<código>` (302).
+- `links.js`: onde os links ficam guardados (na memória) e a validação dos endereços.
+- `paginas/index.html`: a página (HTML, CSS e o JavaScript do formulário). Mude à vontade.
+- `paginas/nao-encontrado.html`: a página de link que não existe.
+
+Não tem banco de dados: os links ficam na memória do app e **somem quando ele é publicado
+de novo**. Veja no fim como guardar de vez.
+
+## Rodar no seu computador
+
+Precisa de Node.js 20 ou mais novo.
+
+```bash
+git clone https://git.dado.cloud/<sua-conta>/encurtador-express.git
+cd encurtador-express
+npm install
+npm run dev
+```
+
+Abra http://localhost:3000.
+
+Quando o `git clone` pedir usuário e senha, use o usuário da sua conta de Repositórios e,
+como senha, o **token de Repositórios** (no painel da Dado, em Repositórios). O comando
+certinho do seu app aparece no painel, em Deploys, na visão geral do app.
+
+## Mudar e publicar
+
+Edite o que quiser e mande para a Dado:
+
+```bash
+git add .
+git commit -m "Minha primeira mudança"
+git push
+```
+
+O push na branch `main` publica uma versão nova. Dá para acompanhar o andamento em
+Deploys, no painel.
+
+## Variável de ambiente de exemplo
+
+A mensagem em "Sobre este deploy" vem da variável `MENSAGEM_BOAS_VINDAS`. Para trocar,
+abra Deploys no painel, clique em "Variáveis de ambiente" no seu app, salve e publique de
+novo. No seu computador:
+
+```bash
+MENSAGEM_BOAS_VINDAS="Oi, mundo" npm run dev
+```
+
+## API
+
+```bash
+# Encurtar
+curl -X POST https://<endereço-do-seu-app>/api/links \
+  -H 'Content-Type: application/json' \
+  -d '{"url": "https://exemplo.com.br/uma-pagina"}'
+# 201 {"codigo":"a1b2c3","url":"https://exemplo.com.br/uma-pagina","curto":"https://<endereço-do-seu-app>/a1b2c3","cliques":0,"criadoEm":"..."}
+
+# Últimos 20 links
+curl https://<endereço-do-seu-app>/api/links
+# 200 {"links":[...]}
+```
+
+`GET /<código>` redireciona (302) para o link original e soma um clique. A API aceita
+chamadas de qualquer site (CORS aberto só em `/api/*`), então outro app seu pode usá-la.
+Para evitar abuso, cada IP cria no máximo 30 links a cada 10 minutos.
+
+## Guardar os links de vez
+
+Para os links sobreviverem a uma nova publicação, ligue um Postgres no app (painel, em
+Deploys, aba "Banco de dados" do app). A conexão chega ao app na variável `DATABASE_URL`;
+aí é trocar o que está em `links.js` por consultas ao banco.