Pruebas de API para Principiantes: Guia Practica

Que es una API

Una API (Application Programming Interface) es un contrato entre dos programas. Define como un programa puede solicitar datos o acciones a otro programa. Cuando usas una app movil que muestra el clima, esa app envia una solicitud a una API meteorologica que responde con los datos actuales.

Las API REST (Representational State Transfer) son el tipo mas comun en la web. Usan el protocolo HTTP — el mismo que tu navegador — con URL para identificar recursos y metodos HTTP para definir acciones.

Probar una API significa verificar que responde correctamente a diferentes solicitudes: datos correctos, datos incorrectos, datos faltantes, autenticacion valida o invalida.

Los Metodos HTTP

• GET: Recuperar datos. GET /api/users/42 retorna el usuario con ID 42. No modifica nada en el servidor.
• POST: Crear un recurso. POST /api/users con un cuerpo JSON crea un nuevo usuario.
• PUT: Reemplazar un recurso completo. PUT /api/users/42 reemplaza todos los datos del usuario 42.
• PATCH: Modificar parcialmente un recurso. PATCH /api/users/42 actualiza solo los campos enviados.
• DELETE: Eliminar un recurso. DELETE /api/users/42 elimina el usuario.

Codigos de Estado HTTP

• 200 OK: La solicitud fue exitosa. El cuerpo contiene los datos solicitados.
• 201 Created: Un recurso fue creado (respuesta tipica a un POST exitoso).
• 400 Bad Request: La solicitud esta mal formada. Datos faltantes, formato incorrecto o validacion fallida.
• 401 Unauthorized: Autenticacion requerida o token invalido.
• 403 Forbidden: La autenticacion es valida pero no tienes permisos para este recurso.
• 404 Not Found: El recurso solicitado no existe.
• 500 Internal Server Error: El servidor encontro un error. Es un bug del lado del servidor.

Que Probar

• Caso feliz: Entradas correctas producen salidas correctas. Es el minimo.
• Validacion: Los campos obligatorios faltantes retornan 400 con un mensaje de error claro, no 500.
• Casos limite: Cadenas vacias, cadenas muy largas, caracteres especiales, cero, numeros negativos, valores null.
• Autenticacion: Las solicitudes sin token retornan 401. Las solicitudes con token expirado retornan 401. Las solicitudes a datos de otro usuario retornan 403.
• Rendimiento: El tiempo de respuesta bajo carga. Un GET que tarda 200ms con 10 usuarios puede tardar 5 segundos con 1,000.
• Paginacion: Los grandes conjuntos de datos deben estar paginados. Verifica tamano de pagina, total y enlaces de navegacion.

Herramientas de Pruebas Populares

• cURL: La herramienta de linea de comandos presente en todos los sistemas Unix. Perfecta para pruebas rapidas y scripts de automatizacion.
• Postman: Aplicacion de escritorio con interfaz grafica para construir solicitudes, organizar colecciones y automatizar pruebas.
• Herramientas en linea: Para pruebas puntuales sin instalar nada, los testers de API en el navegador son la solucion mas rapida.

Prueba en tu Navegador

Nuestro Tester de API te permite enviar solicitudes HTTP a cualquier API directamente desde tu navegador. Define el metodo, la URL, los headers y el cuerpo, luego ve la respuesta con JSON formateado, codigo de estado y tiempo de respuesta. Sin software que instalar.