Tu primera API REST
Una API REST es una app que otras apps consultan por internet: una app de celular, una página web u otro servidor. Cada consulta es una petición HTTP con un método (GET para leer, POST para crear…) y una ruta, como
/pedidos/1.GET /pedidos/1 ← petición
200 ← respuesta: código
{"id":1,"producto":"tacos","total":120.0}
La respuesta trae un código de estado (200 = todo bien, 404 = no existe) y un cuerpo, casi siempre en JSON: texto con llaves, nombres entre comillas y valores. Es el idioma común de las APIs.
En Spring, una clase con
@RestController atiende peticiones. @GetMapping("/hola") dice qué ruta y qué método atiende cada método de Java, y lo que devuelves es la respuesta. Por dentro, Tomcat recibe la petición en su puerto y Spring llama al método que atiende esa ruta.@RestController
class SaludoController {
@GetMapping("/hola")
String hola() { return "¡Hola desde la API!"; }
}
Si devuelves un record, Spring lo convierte a JSON solo (con Jackson); una lista sale como arreglo JSON, entre corchetes:
[{…},{…}], o [] si está vacía. Con @RequestMapping("/pedidos") sobre la clase, todas sus rutas empiezan con /pedidos. @RestController es @Controller (atiende peticiones web) + @ResponseBody.record Pedido(int id, String producto,
double total) { }
@RestController
@RequestMapping("/pedidos")
class PedidosController {
@GetMapping
List<Pedido> todos() { ... }
}
// GET /pedidos responde un arreglo:
// [{"id":1,"producto":"tacos","total":120.0}]
