Como Criar Spring Boot do Zero: API REST Simples e Funcional em Poucos Minutos

Resposta rápida: como criar Spring Boot e subir sua primeira API

Se você quer criar Spring Boot de forma prática, o caminho mais rápido é este: gerar um projeto no Spring Initializr, adicionar a dependência Spring Web, criar um controller com um endpoint /hello e testar no navegador ou no Postman.

Em poucos minutos, você já terá uma API REST rodando localmente. A ideia aqui é sair do zero com algo funcional, sem enrolação e sem pular etapas importantes.

O que vamos construir

Vamos criar uma API REST simples com Spring Boot que responde uma mensagem em uma rota GET. Esse exemplo é pequeno de propósito: ele serve como base para você evoluir depois com banco de dados, validação, DTOs e autenticação.

Pré-requisitos

• JDK 17 ou superior
• IDE como IntelliJ IDEA, Eclipse ou VS Code
• Maven ou Gradle
• Postman opcional, mas útil para testar requisições

1. Criando o projeto no Spring Initializr

Acesse start.spring.io e configure o projeto assim:

• Project: Maven
• Language: Java
• Spring Boot: 3.x
• Dependencies: Spring Web e Spring Boot DevTools

Se quiser entender melhor a base antes de seguir, vale ler também o que é Spring Boot.

2. Estrutura básica do projeto

Depois de baixar e abrir o projeto na IDE, a estrutura inicial costuma ficar assim:

src
└── main
    ├── java
    │   └── com.example.demo
    │       ├── DemoApplication.java
    │       └── controller
    │           └── HelloController.java
    └── resources
        └── application.properties

Você não precisa complicar agora. Para começar, basta uma aplicação, um controller e um endpoint simples.

3. Criando seu primeiro endpoint REST

Crie a classe HelloController.java dentro do pacote controller:

package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Olá, Javalizando!";
    }
}

Esse é o tipo de exemplo que ajuda de verdade quando você está começando: simples, testável e fácil de adaptar para outros retornos.

Exemplo real de uso

Imagine que, em vez de retornar uma mensagem fixa, sua API precise responder algo como:

{
  "status": "ok",
  "mensagem": "API Spring Boot funcionando"
}

Você pode evoluir o mesmo endpoint para retornar JSON, criar objetos de resposta e depois conectar com banco de dados. O início é o mesmo.

4. Rodando a aplicação

Abra a classe DemoApplication.java e execute o projeto. Se estiver tudo certo, o Spring Boot vai subir na porta 8080 por padrão.

Você verá algo parecido com isso no terminal:

Tomcat started on port(s): 8080

5. Testando no navegador ou no Postman

Agora acesse:

http://localhost:8080/api/hello

Se estiver tudo correto, a resposta será:

Olá, Javalizando!

No Postman, o teste é ainda mais útil quando você começar a trabalhar com POST, PUT e DELETE.

Bloco prático: transforme esse exemplo em uma API útil

Se quiser sair do tutorial e praticar de forma mais realista, tente este passo a passo:

1. Troque a mensagem fixa por um JSON.
2. Crie uma classe ResponseDTO para organizar a resposta.
3. Adicione uma rota /api/status com informações da aplicação.
4. Depois, crie uma rota /api/usuarios retornando uma lista simulada.

public record StatusResponse(String status, String mensagem) {}

Esse tipo de evolução já aproxima seu projeto de uma API de verdade, sem sair do contexto inicial.

Erro comum: endpoint não abre no navegador

Um dos erros mais comuns ao criar Spring Boot é tentar acessar a rota e receber Whitelabel Error Page ou 404. Normalmente isso acontece por um destes motivos:

• o controller não está no pacote escaneado pelo Spring
• o @RequestMapping foi digitado com caminho diferente do acessado
• a aplicação não foi iniciada corretamente
• a classe principal está fora da estrutura de pacotes esperada

Confira sempre se o pacote do controller está abaixo do pacote principal da aplicação. Esse detalhe simples evita muita perda de tempo.

Próximos passos para evoluir sua API

• Adicionar Spring Data JPA para persistência
• Criar DTOs para entrada e saída de dados
• Usar validação com Bean Validation
• Documentar a API com Swagger/OpenAPI
• Implementar tratamento global de erros
• Proteger endpoints com Spring Security e JWT

Se esse for seu próximo passo, vale continuar com este guia: Guia completo de Spring Data JPA no Spring Boot.

FAQ: dúvidas comuns sobre criar Spring Boot

1. Preciso saber Java avançado para começar?

Não. Com noções básicas de classes, métodos e pacotes, você já consegue montar sua primeira API com Spring Boot.

2. Spring Boot serve para API REST?

Sim. Esse é um dos usos mais comuns do framework. Ele facilita bastante a criação de endpoints e a organização da aplicação.

3. Posso usar Maven ou Gradle?

Sim. Os dois funcionam bem. Neste tutorial, o caminho mais simples é usar Maven.

4. Qual dependência é obrigatória para criar uma API REST?

A principal é Spring Web, porque ela traz os recursos para criar controllers e endpoints HTTP.

5. Como saber se minha API está funcionando?

Se a aplicação subir sem erro e o endpoint responder no navegador ou no Postman, sua API já está funcionando corretamente.

Conclusão

Agora você já sabe como criar Spring Boot e colocar sua primeira API REST para rodar do zero. Esse exemplo é simples, mas é exatamente o tipo de base que ajuda a aprender do jeito certo: construindo, testando e evoluindo aos poucos.

O próximo passo natural é transformar essa API em algo mais completo, com banco de dados, camadas bem definidas, validação e segurança. Se quiser continuar estudando, vale aprofundar em Java para backend, Spring Boot Actuator e testes de integração com Spring Boot.

Leitura complementar

Se voce quiser aprofundar esse assunto com um material mais atual, leia tambem Validar DTO Spring Boot com mensagens personalizadas sem erro.