Iniciar sesión

Códigos de estado y ResponseEntity en Spring Boot

200, 201, 204, 404… y cuándo usar cada uno

Unidad: APIs REST Gratis
🚦
Códigos de estado y ResponseEntity
El código de estado le dice al cliente qué pasó antes de leer el cuerpo. Los 200 son éxito; los 400, error de quien pidió; los 500, error del servidor. Los que más usarás:
200 OK todo bien 201 Created se creó algo nuevo 202 Accepted lo recibí; lo hago después 204 No Content listo, sin cuerpo 400 Bad Request la petición viene mal 404 Not Found eso no existe 405 Method Not Allowed ese método no va ahí 415 Unsupported el Content-Type no es JSON 500 Server Error tu código falló
Si tu método devuelve un objeto, Spring responde 200. Para elegir el código, devuelve un ResponseEntity: el cuerpo más el código y las cabeceras (datos extra con nombre y valor que viajan junto al cuerpo, como Location: /pedidos/2).
if (p == null) return ResponseEntity.notFound().build(); return ResponseEntity.ok(p);
Al crear, lo correcto es 201 con la cabecera Location, que dice dónde quedó lo nuevo. Al borrar, 204 sin cuerpo.
return ResponseEntity .created(URI.create("/pedidos/2")).body(p); return ResponseEntity.noContent().build();
Si el código es siempre el mismo, basta @ResponseStatus(HttpStatus.CREATED) sobre el método. Usa ResponseEntity cuando el código depende del caso, como 200 o 404. Si no hay ruta, Spring responde 404 solo; si la ruta existe pero no con ese método, 405.

Pon a prueba lo que aprendiste

Concepto

¿Qué familia de códigos indica un error de quien hizo la petición?

  1. ALos 500
  2. BLos 300
  3. CLos 400
  4. DLos 200
Ver respuesta
C) Los 400 4xx es error del cliente; 5xx, del servidor.
Trazar código

Solo existe el pedido 1. Haces GET /pedidos/9. ¿Qué responde?

record Pedido(int id, String producto, double total) { } @RestController @RequestMapping("/pedidos") class PedidosController { private final Map<Integer, Pedido> pedidos = new TreeMap<>(Map.of(1, new Pedido(1, "tacos", 120.0))); @GetMapping("/{id}") ResponseEntity<Pedido> uno(@PathVariable int id) { Pedido p = pedidos.get(id); if (p == null) return ResponseEntity .notFound().build(); return ResponseEntity.ok(p); } }
  1. A400: el 9 no es válido
  2. B200 con null
  3. C404 sin cuerpo
  4. D500: el pedido es null
Ver respuesta
C) 404 sin cuerpo ResponseEntity elige el código; build() sin cuerpo.
Trazar código

Mandas POST /pedidos con un pedido válido a este método. ¿Qué recibe el cliente?

record Pedido(int id, String producto, double total) { } record NuevoPedido(String producto, int cantidad) { } @PostMapping ResponseEntity<Pedido> crear( @RequestBody NuevoPedido nuevo) { Pedido p = ...; // el pedido 2, ya guardado return ResponseEntity .created(URI.create("/pedidos/2")) .body(p); }
  1. A200 y el pedido en JSON, sin ninguna cabecera extra
  2. B302 y una redirección automática a /pedidos/2
  3. C201 sin cuerpo y sin ninguna cabecera extra
  4. D201, la cabecera Location=/pedidos/2 y el pedido en JSON
Ver respuesta
D) 201, la cabecera Location=/pedidos/2 y el pedido en JSON 201 Created dice dónde quedó lo nuevo.

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.