Cómo escribir tu primera API REST en Spring Boot

Spring Boot se ha convertido en el estándar para crear aplicaciones de backend en Java. Su fuerza reside en la simplicidad y la velocidad: puedes crear una API REST funcional en solo unos minutos. En este artículo, veremos cómo dar el primer paso.

La API REST es una forma de comunicación entre el cliente y el servidor a través de solicitudes HTTP. Algunos ejemplos:

• GET /users — obtener una lista de usuarios

• POST /users — crear un nuevo usuario

• DELETE /users/1 — eliminar usuario con ID = 1

  

Paso 1. Creación del proyecto

La forma más rápida de comenzar es a través de Spring Initializr:

1. Indicamos el idioma — Java.

2. Elegimos la dependencia: Spring Web.

3. Descargamos y abrimos el proyecto en IDE (IntelliJ IDEA, Eclipse o VS Code).

Paso 2. Primer controlador

En la carpeta src/main/java creamos una clase:

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

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hi, this is my first REST API!";
    }
}

¿Qué está pasando?

• @RestController — la clase es responsable de las solicitudes REST.

• @GetMapping("/hello") — procesa la solicitud GET en /hello.

• El método devuelve una cadena y se muestra en el navegador.

Paso 3. Ejecutar la aplicación

El proyecto ya tiene una clase con la anotación @SpringBootApplication. Lo ejecutamos. Vamos al navegador en http://localhost:8080/hello y vemos la respuesta de la API. 🎉

Paso 4. Trabajar con los datos

Añadiremos una lista de usuarios:

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;

@RestController
public class UserController {

    @GetMapping("/users")
    public List<String> getUsers() {
        return List.of("Alice", "Bob", "Eva");
    }
}

Ahora, cuando solicitemos /users, obtendremos JSON:

["Alice", "Bob", "Eva"]

¿Qué sigue?

• Añadir los métodos POST, PUT, DELETE.

• Conectar la base de datos (Spring Data JPA).

• Configurar pruebas y documentación (por ejemplo, Swagger).

Conclusión

Spring Boot te permite implementar rápidamente la API REST: desde la primera solicitud hasta trabajar con los datos, solo unas pocas líneas de código. Una vez dominada la base, se pueden construir servicios completos, desde proyectos de formación hasta microservicios.

Para sentirse seguro en Java y Spring Boot, es importante comprender los conceptos básicos de programación. En la aplicación Kodik puedes aprender Python, JavaScript, Lua y otros lenguajes, tomar cursos y obtener un certificado. Este es un excelente punto de partida para pasar a marcos de back-end serios.

Y también tenemos un canal de telegram, donde discutimos ideas geniales, compartimos experiencias y analizamos juntos las tareas: aprender no solo es útil, sino también divertido.