Domina las pruebas de tu API con herramientas confiables. Aquí verás cómo usar Postman y Curl para listar, crear y borrar pacientes en Django Rest Framework, convertir requests a Curl y evitar errores comunes como la barra final. Todo de forma clara, práctica y replicable.
¿Por qué usar Postman y Curl para probar APIs?
Postman ofrece una interfaz potente para construir y guardar requests, ideal para explorar y depurar. Curl, en cambio, permite ejecutar requests desde la línea de comandos, perfecto en servidores sin interfaz gráfica.
- La interfaz visual de Django Rest Framework no es estándar en otras APIs.
- Postman facilita colecciones reutilizables y pruebas rápidas.
- Curl es útil en entornos remotos sin ventanas.
- Ambos ayudan a simular comportamientos de usuarios con requests manuales.
- Son clave para depurar en entornos locales y productivos.
¿Cómo ejecutar requests en Postman con Django Rest Framework?
Configura el método, pega la URL y ejecuta. Puedes duplicar pestañas, guardar colecciones y trabajar con detalle por ID.
- Lista de pacientes: método GET a http://localhost:8000/api/patients/.
- Detalle: duplicar y agregar el ID en la URL del endpoint.
- Borrado: método DELETE sobre el ID devuelve 204 sin contenido.
- Creación: método POST con body en formato JSON en modo raw.
- Evita errores por barra final: agrega “/” al terminar la URL.
Ejemplos con Curl equivalentes:
# Listado
curl -X GET http://localhost:8000/api/patients/
# Detalle por ID
curl -X GET http://localhost:8000/api/patients/ID/
# Borrado
curl -X DELETE http://localhost:8000/api/patients/ID/
# Creación (JSON en el body)
curl -X POST http://localhost:8000/api/patients/ \
-H "Content-Type: application/json" \
-d '{ "...": "...", "nombre": "Oscar Barajas" }'
Puntos clave:
- En POST, selecciona raw y JSON en Postman antes de enviar.
- Tras crear, vuelve a listar para verificar que aparece “Oscar Barajas”.
- El status de borrado es 204, no retorna contenido.
¿Cómo generar Curl desde Postman y validar en la terminal?
Postman puede convertir cualquier request a Curl con el ícono de “código”. Copia y pégalo en la terminal para ejecutar exactamente el mismo request.
- En Postman, usa el ícono “código” para obtener el Curl del request.
- Pega el comando en la consola para validar el response real.
- Django Rest compacta el response quitando espacios para ahorrar bytes.
- Postman “prettifica” según reglas de JSON, haciéndolo legible.
- Puedes armar una suite de pruebas cambiando valores y ejecutando comandos.
Tip de productividad:
- Guarda tus requests como colección en Postman.
- Duplica y ajusta solo método, URL o body para CRUD completo.
- Reutiliza el Curl exportado en scripts de prueba.
¿Te fue útil? Comparte en comentarios cómo organizas tu colección de Postman para agregar, modificar y borrar pacientes en tu Doctor App.
