Tema 5 · Payloads JSON

Peticiones POST, PUT y PATCH con Cuerpos JSON (Raw Body)

Aprende a enviar cargas útiles en formato JSON con POST, PUT y PATCH, configurar la cabecera Content-Type correcta y dominar la diferencia entre reemplazo total y parcial.

Peticiones GET y Parámetros de Consulta (Query Params) Formularios form-data y Pruebas de Subida de Archivos

¿Cómo Enviar Datos al Servidor en Formato JSON?

Cuando necesitas crear un nuevo usuario, registrar una compra o actualizar el perfil de un cliente, los verbos POST, PUT y PATCH transportan un cuerpo de datos (Payload) hacia el backend.

En las arquitecturas REST modernas, el formato estándar indiscutible para este intercambio es JSON (JavaScript Object Notation).

Paso a Paso: Configurar el Cuerpo JSON en Postman

  1. Selecciona el método HTTP deseado (ejemplo: POST).
  2. Escribe la URL del endpoint (ejemplo: https://api.kilopolis.com/v1/articulos).
  3. Debajo de la barra de URL, haz clic en la pestaña Body.
  4. Entre las opciones disponibles, selecciona el botón de opción raw (datos puros).
  5. En el menú desplegable que aparece a la derecha (que por defecto dice Text), cámbialo a:
    JSON.
  6. Escribe o pega tu objeto JSON con llaves { ... } y comillas dobles en las claves.
  7. El Botón "Beautify": En la esquina superior derecha del editor de texto, pulsa en Beautify para identar y validar la sintaxis automáticamente. Si olvidaste una coma o cerraste mal una llave, Postman te avisará con una cruz roja antes de enviar la petición.
💡 Magia Automática de Postman: Al seleccionar raw ➔ JSON, Postman inyecta de forma transparente la cabecera HTTP indispensable:
Content-Type: application/json. Sin esta cabecera, servidores en Laravel, Express o Spring Boot ignorarían el cuerpo de la petición.

Diferencia Crucial en REST: PUT vs PATCH

Método Tipo de Actualización Payload Requerido Consecuencia si Omites Campos
PUT Reemplazo Total Debes enviar todos los campos del recurso (nombre, email, teléfono, dirección). Si omites el campo teléfono, la API asumirá que deseas vaciarlo o borrarlo (lo pondrá en NULL).
PATCH Modificación Parcial Solo envías los campos específicos que cambiaron (ej. {"precio": 49.99}). Los campos no enviados permanecen exactamente iguales en la base de datos sin alterarse.

⚡ Petición POST para Registrar un Nuevo Usuario en la API

Estructura JSON completa para enviar en la pestaña Body raw:

crear-usuario.json
Solo lectura 
{
  "nombre": "Carlos",
  "apellido": "Gómez",
  "email": "[email protected]",
  "rol": "desarrollador",
  "perfil": {
    "especialidad": "Full Stack PHP & JavaScript",
    "biografia": "Entusiasta de las APIs REST y la automatización con Postman."
  },
  "habilidades": [
    "PHP 8.3",
    "Postman",
    "MySQL",
    "Docker"
  ],
  "notificaciones_activas": true
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué en una API REST bien diseñada se debe utilizar el método PATCH en lugar de PUT para actualizar únicamente la contraseña de un usuario?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Manual de Postman: Pruebas de APIs REST & Automatización y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

Conocer el Bootcamp

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.