Cómo probar APIs con Postman y curl

Contenido del curso

Fundamentos de Django Rest Framework

Vistas y Endpoints

Serializadores Avanzados

Testing y Desempeño

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:005:47

Cómo probar APIs con Postman y curl

Curso de Django Rest Framework

Clase 9 de 21

Clase 9 / 21

Recursos

Probar endpoints de forma eficiente es una habilidad fundamental para cualquier desarrollador que trabaje con APIs. Aunque Django REST Framework ofrece una interfaz visual para hacer pruebas rápidas, en la práctica profesional se utilizan herramientas más robustas y versátiles como Postman y Curl, que permiten simular peticiones reales y depurar código tanto en entornos locales como productivos.

¿Por qué no basta con la interfaz visual de Django REST Framework?

La interfaz que Django REST Framework incluye por defecto es útil para pruebas iniciales, pero no es un estándar en la industria. APIs de terceros como Stripe utilizan formatos completamente diferentes para ser probadas [0:20]. Por esta razón, es necesario dominar herramientas dedicadas que ofrecen mayor control sobre las peticiones HTTP.

Postman es una aplicación con múltiples funcionalidades diseñada para construir, probar y documentar APIs. Por otro lado, Curl es una herramienta de línea de comandos que permite ejecutar requests directamente desde la terminal [0:48]. Curl resulta especialmente útil cuando trabajas en un servidor sin interfaz gráfica y necesitas validar que la API responde correctamente.

¿Cómo hacer peticiones GET, POST y DELETE con Postman?

Una vez descargado e instalado Postman desde su página oficial, la interfaz principal permite seleccionar el método HTTP y escribir la URL del endpoint [1:12].

¿Cómo listar y consultar recursos?

Para obtener la lista de pacientes, basta con configurar un request GET a http://localhost:8000/api/patients/ y presionar send [1:28]. El resultado aparece formateado en la parte inferior respetando las reglas de JSON. También es posible:

Abrir nuevas pestañas para diferentes requests.
Agregar un ID a la URL para consultar el detalle de un paciente.
Cambiar el método a DELETE para eliminar un recurso, obteniendo un código 204 sin contenido en la respuesta [1:48].

Postman permite guardar cada request como parte de una colección, lo que facilita reutilizarlos en el futuro.

¿Cómo crear un recurso con POST?

Para crear un nuevo paciente, se selecciona el método POST y se configura el body del request [2:38]. En Postman esto se hace desde la pestaña Body, seleccionando la opción raw y eligiendo el formato JSON. Luego se escribe el objeto con los datos del paciente, por ejemplo con el nombre "Oscar Barajas" [2:55].

Un detalle importante: si olvidas agregar el slash al final de la URL, Django devolverá un error [3:15]. Una vez corregido, la respuesta confirma la creación del recurso.

¿Cómo convertir peticiones de Postman a Curl?

Una funcionalidad muy práctica de Postman es la posibilidad de exportar cualquier request como comando Curl [2:05]. En la parte derecha de la interfaz hay un ícono de código que genera el comando equivalente listo para copiar y pegar en la terminal.

Al ejecutar Curl desde la consola, la respuesta llega comprimida, sin espacios ni saltos de línea [2:18]. Django REST Framework hace esto intencionalmente para reducir el tamaño de la respuesta en bytes y mejorar el rendimiento del endpoint. A diferencia de Postman, que formatea automáticamente el JSON para facilitar la lectura.

Este flujo de trabajo es especialmente valioso para crear suites de pruebas automatizadas: puedes generar los comandos Curl desde Postman, modificar los valores según necesites y ejecutarlos en secuencia [3:38].

Postman y Curl cumplen roles complementarios en el desarrollo de APIs. Postman ofrece una experiencia visual e interactiva ideal para el desarrollo local, mientras que Curl brinda la flexibilidad necesaria para depurar en instancias productivas y simular comportamientos de usuarios mediante peticiones fabricadas manualmente [3:50]. Crear una colección en Postman con todas las operaciones de tu API es un excelente primer paso para mantener un flujo de pruebas organizado.

Christopher Andrés Guano Valencia

Hace 2 años

🟢 Qué es cURL

curl es una herramienta de línea de comandos que se utiliza para transferir datos a través de diferentes protocolos, como HTTP, HTTPS, FTP y más.

Es muy útil para interactuar con APIs, descargar archivos o enviar datos a servidores. Su principal ventaja es que permite hacer solicitudes de forma sencilla y versátil.

Se puede hacer una solicitud GET:

curl https://api.ejemplo.com/datos

Hacer una solicitud POST

curl -X POST -d "param1=valor1&param2=valor2" https://api.ejemplo.com/submit

Descargar un archivo

curl -O https://ejemplo.com/archivo.zip

Inclusive añadir parámetros de autenticación en los headers de la petición.

curl -H "Authorization: Bearer TOKEN" https://api.ejemplo.com/protegido

¡Nunca pares de aprender! 🚀🚀

Comentarios (10)10 comentarios

kolab Linkear

Una opción muy similar a Postman es Insomnia, cuenta con una interfaz bastante amigable😅:

JUAN PABLO MAYORGA MENDIETA

excelente, también puede integrarse con vscode

recomiendo la extensión thunder client de vscode

Slash Prototype

La versión gratuita no permite el uso en WSL

Juan Camilo Jaramillo Tascón

Comparto mi colección creada en Postman para cada uno de los métodos explicados en clase.

Antonio Demarco Bonino

Para elegir entre Postman y cURL le pedí a ChatGPT que me de una mano y su respuesta me sorprendió. Les dejo sus comentarios:

¿Cuándo usar Postman?

Cuando prefieres una interfaz gráfica fácil de usar.
Para organizar pruebas de APIs en colecciones y ejecutarlas repetidamente.
Si necesitas una herramienta que almacene el historial de solicitudes, gestione colecciones, y te ayude con autenticaciones complejas como OAuth o JWT.
Para generar automáticamente documentación de tus APIs o compartir colecciones con tu equipo.

¿Cuándo usar cURL?

Si prefieres trabajar desde la línea de comandos.
Cuando necesitas una herramienta ligera y no quieres instalar software adicional.
Para realizar solicitudes rápidas y sencillas sin requerir una interfaz gráfica.
Si estás automatizando tareas o probando APIs desde scripts bash o pipelines CI/CD.

Conclusión:

Postman es más fácil de usar y tiene una interfaz intuitiva, lo que la hace ideal para pruebas más complejas, colaboraciones en equipo y documentar APIs.
cURL es más ligera y adecuada para usuarios avanzados que están familiarizados con la línea de comandos y que prefieren integrar pruebas simples en scripts o entornos automatizados.

Julio Bastidas

Hace un año

Les recomiendo Bruno,

Manuel Galindo

Ventajas de Postman:

Interfaz gráfica intuitiva.
Automatización de pruebas.
Facilita la colaboración.

Ventajas de cURL:

Ligero y flexible.
Compatible con múltiples sistemas.
Fácil integración en scripts.

Carlos Andres Alavez Santiago

Hace 7 meses

En el archivo de serializar agregue lo siguiente para evitar duplicados validando, nombre, apellido, fecha de nacimiento, el iexact hace una comparación sin el case sensitive

def validate(self, data):
        first_name = data.get("first_name")
        last_name = data.get("last_name")
        date_of_birth = data.get("date_of_birth")


        patient_exists = Patient.objects.filter(
            first_name__iexact=first_name,
            last_name__iexact=last_name,
            date_of_birth=date_of_birth
        ).exists()


        if patient_exists:
            raise serializers.ValidationError(
                "Ya existe un paciente con el mismo nombre, apellido y fecha de nacimiento."
            )


        return data

def validate(self, data):

first_name = data.get("first_name")

last_name = data.get("last_name")

date_of_birth = data.get("date_of_birth")

patient_exists = Patient.objects.filter(

first_name__iexact=first_name,

last_name__iexact=last_name,

date_of_birth=date_of_birth

).exists()

if patient_exists:

raise serializers.ValidationError(

"Ya existe un paciente con el mismo nombre, apellido y fecha de nacimiento."

)

return data

Bryan Castano

Hace 9 meses

Postman es una excelente herramienta, pero Yo soy más de cURL Team, porque es facil para trabajar en la linea de comandos, no necesitas instalar nada extra, se usa desde terminal.

Solo descargarse con apt-get curl, es lijero y rapido, Curl permite realizar soliccitudes rapidas y sencillas sin requerir una interfaz grafica, epsecial para trabajo en servidores remotos por SSH en Bash script, lo cual es miu util en automatización de APIs desde Bash para

pipelines CI/CD y es mas Linux Friendly.

Tambien es el estandard en test de scripting y automatizacion , siempre ha ha sido confiable para probar API en Desarrollo Dev.

Andres Trujillo

Durante el curso pues vine utilizando la interfaz de swagger para ver la experiencia y uf fue una experiencia fastidiosa, sabia de la sixtencia de postman, pero aun así me sumergí en la experiencia, conclusión postman > swagger python hihi

Luis Martinez

Profesor

Hay que aprender a utilizar ambas puesto que muchas veces compartir la documentación por medio de Swagger es la manera favorita de Otros ingenieros

Fundamentos de Django Rest Framework

Django REST Framework para APIs escalables

Qué es una API REST y cómo usar JSON

Configuración de Django REST Framework paso a paso

Django Rest: qué reutiliza de Django

Serializers Django: modelos a JSON fácil

Listado de pacientes con serializers en DRF

POST y GET en el mismo endpoint con Django REST

CRUD completo con PUT y DELETE en Django Rest

Cómo probar APIs con Postman y curl

Django Rest Framework: de funciones a vistas genéricas

Vistas genéricas en Django Rest Framework

Documentación automática de APIs con drf-spectacular

Vistas y Endpoints

ViewSets vs APIView: refactor automático de URLs

Acciones personalizadas en ViewSets REST

Autenticación y permisos en Django Rest Framework

Validaciones custom en Django Rest Framework

Serializadores Avanzados

Serializadores anidados en Django REST Framework

Calcular campos dinámicos con SerializerMethodField

Endpoint anidado para citas en Django REST

Testing y Desempeño

Tests de API con APIClient en Django

Throttling en Django Rest para evitar ataques DOS

Cómo probar APIs con Postman y curl

Progreso del curso

Fundamentos de Django Rest Framework

Vistas y Endpoints

Serializadores Avanzados

Testing y Desempeño

Recursos

Recursos