Probar endpoints de forma profesional es clave para asegurar calidad y velocidad en desarrollo. Aquí verás cómo usar Postman y curl para validar tu API en Django REST Framework, crear colecciones reutilizables, convertir requests a consola y detectar errores comunes como el slash final faltante.
¿Qué herramientas usar para probar APIs REST?
La interfaz visual de Django REST Framework es útil, pero no es estándar en APIs de terceros. Por eso conviene dominar Postman y curl. Postman ofrece una interfaz rica para armar y guardar requests. curl permite ejecutar requests HTTP desde la línea de comandos, ideal en servidores sin interfaz gráfica.
- Postman: crear y guardar requests en colecciones. Duplicar pestañas para variantes. Ver respuestas formateadas en JSON.
- curl: ejecutar requests desde terminal. Validar respuestas rápidamente. Útil en entornos locales y productivos.
- Beneficio clave: simular comportamientos de usuarios con peticiones fabricadas manualmente.
¿Cómo probar endpoints con Postman paso a paso?
Primero, configura la URL base de desarrollo: http://localhost:8000. Para el recurso de pacientes usa el endpoint: http://localhost:8000/api/patients.
- Lista con GET: selecciona el método GET, pega la URL y presiona Send. Verás la lista en la parte inferior.
- Guardar y reutilizar: guarda el request en una colección. Crea nuevas pestañas para otras operaciones.
- Detalle con ID: duplica la pestaña, agrega el ID al final de la URL y envía el request para ver el detalle.
- Borrado con DELETE: duplica de nuevo, cambia a DELETE. La respuesta esperada es sin contenido y código 204.
- Creación con POST: cambia a POST, ve a Body > raw y selecciona JSON. Pega el cuerpo con los datos del paciente, por ejemplo un nombre como "Oscar Barajas". Envía el request.
- Error común: si falta el slash final en la URL, aparecerá un error. Añádelo y reintenta para ver el estado creado.
- Verificación: vuelve al listado con GET y confirma que aparece el nuevo registro.
- Código a consola: en Postman usa el ícono code para obtener el curl equivalente de cualquier request.
Claves que estarás practicando: elección de métodos HTTP (GET, POST, DELETE), manejo de endpoints y colecciones, envío de body en formato JSON, y lectura de códigos de estado.
¿Cómo ejecutar requests con curl desde la consola?
Postman permite exportar un request a curl con el ícono code. Cópialo y ejecútalo en tu terminal para probar los endpoints sin interfaz gráfica.
- Conversión directa: genera el curl del listado para http://localhost:8000/api/patients y ejecútalo.
- Respuesta comprimida: verás el JSON sin espacios porque Django REST reduce bytes para responder más rápido. En Postman, el JSON se formatea automáticamente.
- Suite de pruebas: usa varios comandos curl para crear, listar, detallar y borrar, cambiando valores según necesites.
- Uso en servidores: perfecto cuando solo cuentas con consola y necesitas validar que la API responde lo esperado.
¿Ya creaste tu colección en Postman para agregar, modificar y borrar en tu Doctor App? Cuéntame cómo armas tus requests y si usas curl para tu suite de pruebas.
