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.