Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Developer Workspace

    O que é REST?

    REST organiza uma API em recursos acessíveis por URL e método HTTP. Entenda recurso, verbo, caminho e como a URL comunica o que a chamada faz.

    Também chamado de: API REST, Representational State Transfer, estilo REST

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    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

    O que é REST

    REST, de Representational State Transfer, é um estilo de organização de API em que os recursos são acessados por uma combinação de URL e método HTTP. A URL identifica o recurso, e o método comunica a ação pretendida.

    O estilo ajuda a entender a API olhando para a chamada. Em vez de nomes de função abstratos, o caminho identifica o que existe, e o verbo informa o que está sendo feito. A leitura da URL comunica o propósito.

    Recurso e caminho

    O recurso é o que a API expõe: um usuário, um pedido, um pet. O caminho identifica o recurso e, quando necessário, o elemento específico dentro dele. O método define a operação sobre o caminho.

    Uma mesma URL pode responder de formas diferentes conforme o verbo. Consultar, criar, substituir ou remover usam métodos distintos sobre o mesmo recurso. A combinação de caminho e método comunica a chamada.

    A mesma URL com ações diferentestext
    GET    /pets      → consultar a lista
    POST   /pets      → criar um pet
    GET    /pets/5    → consultar o pet 5
    DELETE /pets/5    → solicitar a remoção

    Caminhos que comunicam

    O caminho pode se aprofundar para recursos relacionados. Um usuário com seus pedidos pode aparecer em /users/5/orders. O identificador do usuário aparece no caminho, e o recurso relacionado completa a leitura.

    O caminho bem desenhado se lê como uma frase. Identificar o recurso, o elemento e a relação ajuda quem consome a API. A URL comunica a operação e oferece uma primeira orientação sobre a chamada.

    Semântica e estado

    REST se apoia em recurso e estado. O recurso é o que a API expõe, e o estado é a representação atual dele. O HTTP oferece os verbos e os códigos de resposta que expressam a operação.

    Seguir a semântica dos métodos evita surpresas. Usar GET para consultar, POST para criar e DELETE para remover comunica a intenção. A idempotência de alguns métodos orienta o comportamento ao repetir chamadas.

    Para modelar a sua API seguindo o estilo REST, o Desenvolvimento Colaborativo da Dev Side Studio oferece orientação na organização de recursos, caminhos e métodos.

    Dúvidas frequentes

    Perguntas frequentes sobre REST

    REST é um protocolo?
    Não. REST é um estilo de organização de API. Ele se apoia no HTTP, mas não é um protocolo próprio. O HTTP continua definindo métodos e códigos de resposta.
    Toda API chamada de REST segue o mesmo padrão?
    Nem sempre. O termo é usado com variações. O essencial é a organização em recursos com caminhos e métodos que comunicam a ação pretendida.
    O que a URL diz em uma API REST?
    A URL identifica o recurso, e o método comunica a ação. A mesma URL com métodos diferentes pode executar operações diferentes sobre o recurso.
    Uma API precisa ser REST para ser boa?
    Não. O estilo REST atende bem a muitos casos, mas a escolha acompanha a necessidade. Outros formatos também podem entregar APIs eficientes.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Developer Workspace

    REST organiza a API em recursos que combinam caminho e método para comunicar a ação pretendida.

    Conhecer a formação
    Capa da Formação Developer Workspace

    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