Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é rota dinâmica?

    Uma rota dinâmica atende endereços com partes variáveis no caminho. Entenda como o Astro usa os parâmetros na geração estática e nas páginas sob demanda.

    Também chamado de: dynamic route, rota parametrizada

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Endereços com uma parte variável

    Uma rota dinâmica é uma definição de caminho que usa parâmetros para atender vários endereços. Em uma página de artigos, o parâmetro pode identificar qual texto deve ser apresentado. Você mantém uma definição de página e usa o valor recebido no caminho para selecionar o artigo.

    No Astro, o arquivo src/pages/artigos/[slug].astro define uma rota desse tipo. O nome entre colchetes declara a parte variável: o acesso a /artigos/dns/ corresponde ao valor dns de slug. Os colchetes pertencem ao nome do arquivo, não ao endereço que você abre no navegador.

    Geração dos caminhos no Astro

    Uma rota dinâmica pode produzir páginas estáticas. Nesse caso, a função getStaticPaths() informa quais valores o Astro deve usar durante o build. Em um exemplo com os valores dns e cache, a mesma página gera os endereços /artigos/dns/ e /artigos/cache/. Um novo artigo exige que seu caminho seja incluído na geração e publicado.

    Na renderização sob demanda, o Astro recebe o valor por Astro.params.slug durante o acesso. A página usa esse valor para consultar o artigo e montar a resposta. Esse modo exige um adapter compatível com o ambiente de execução e não usa getStaticPaths() para enumerar os endereços.

    Um caminho válido pode apontar para um artigo ausente

    O endereço /artigos/inexistente/ pode corresponder ao formato da rota sob demanda mesmo sem haver um artigo com esse identificador. A aplicação precisa conferir o resultado da consulta e responder com o status HTTP 404 quando o conteúdo não existir. Exibir uma mensagem de ausência com status 200 informa sucesso ao navegador e aos mecanismos de busca.

    Você pode testar um identificador ausente e observar tanto a mensagem quanto o status da resposta. Na versão estática, confira também se o caminho estava entre os gerados. Uma rota parametrizada não cria o registro consultado nem define por si só quais artigos podem ser publicados.

    A consulta do artigo pela rota pode ser investigada no Desenvolvimento Colaborativo da Dev Side Studio, com você operando o editor durante a orientação técnica ao vivo.

    Dúvidas frequentes

    Perguntas frequentes sobre rota dinâmica

    Uma rota dinâmica exige renderização no servidor a cada acesso?
    Não. No Astro, uma rota dinâmica pode gerar páginas estáticas durante o build. A configuração de renderização define se o HTML será produzido previamente ou sob demanda.
    O parâmetro recebido confirma a existência do artigo?
    Não. O endereço pode corresponder ao formato da rota sem haver um artigo com aquele identificador. A aplicação precisa consultar o conteúdo e definir a resposta para a ausência.
    Para que serve getStaticPaths no Astro?
    A função enumera os caminhos de uma rota dinâmica que serão gerados no build. Nas rotas renderizadas sob demanda, o valor chega por Astro.params e getStaticPaths não deve ser usado.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    As rotas parametrizadas permitem apresentar registros de um sistema usando uma definição de página compartilhada.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano