Iniciar sesión

Tu primera API REST en Spring Boot

Peticiones, respuestas y @RestController

Unidad: APIs REST Gratis
🌐
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}]

Pon a prueba lo que aprendiste

Concepto

¿Qué es una API REST?

  1. AUna base de datos que guarda archivos JSON en el servidor
  2. BUn programa que se instala en el celular del cliente
  3. CUna página web con botones y formularios para el cliente
  4. DUna app que otras apps consultan por internet
Ver respuesta
D) Una app que otras apps consultan por internet Tu app responde datos a quien se los pida.
Concepto

En la respuesta de una API, ¿qué significa el código 404?

  1. AEl servidor tuvo un error inesperado
  2. BTodo salió bien
  3. CLo que pediste no existe
  4. DTe faltó iniciar sesión
Ver respuesta
C) Lo que pediste no existe 404 es «no encontrado».
Trazar código

La app tiene este controlador. Haces GET /hola. ¿Qué responde?

@RestController class SaludoController { @GetMapping("/hola") String hola() { return "¡Hola desde la API!"; } }
  1. A200 y un JSON con un campo hola
  2. B200 y el texto ¡Hola desde la API!
  3. C404: falta la página hola.html
  4. D405: hola no es un método HTTP
Ver respuesta
B) 200 y el texto ¡Hola desde la API! Con @RestController lo que devuelves es el cuerpo.

Practica esta lección completa

Ejercicios de completar código, ordenar bloques y respuesta libre. Ganas XP y mantienes tu racha.

Practicar gratis, sin registrarte Entras como invitado directo a esta lección. Sin tarjeta.