Fundamentos de REST APIs

Curso de iniciación al consumo de REST APIs orientado a profesionales técnicos que integran servicios externos en su trabajo diario pero nunca han construido una base formal sobre cómo funcionan. El curso cubre los fundamentos que subyacen a cualquier API REST: la semántica de los métodos HTTP y la estructura de un endpoint, la interpretación de códigos de estado y payloads JSON, el uso eficiente de Postman y curl para explorar APIs desconocidas, la construcción de query parameters para filtrar y ordenar resultados, y la navegación por APIs paginadas leyendo sus metadatos de respuesta. Al finalizar, el participante será capaz de consumir cualquier API REST documentada de forma sistemática, verificar que los resultados son coherentes con los parámetros aplicados y diagnosticar errores a partir del código de estado y el cuerpo de la respuesta.

Al finalizar el curso, el participante será capaz de:

• Identificar los componentes de una REST API —endpoint, recurso, método, cabeceras, cuerpo y respuesta— y describir la semántica de los métodos HTTP principales relacionándolos con operaciones CRUD
• Interpretar los códigos de estado HTTP más comunes (200, 201, 204, 400, 401, 403, 404, 422, 500, 503) y extraer información relevante de payloads JSON en respuestas de API
• Realizar peticiones HTTP con Postman y curl configurando correctamente el método, la URL, las cabeceras y el cuerpo para operaciones con y sin payload
• Aplicar query parameters para filtrar, ordenar y buscar resultados en APIs reales construyendo URLs válidas con sintaxis correcta
• Consumir endpoints con paginación offset-based calculando los valores de offset correctos y verificando los metadatos de respuesta
• Realizar una petición que combine filtrado, ordenación y paginación e identificar si los resultados son coherentes, detectando duplicados o registros omitidos

1. HTTP y REST: métodos y respuestas Componentes de una REST API: endpoint, recurso, método HTTP, cabeceras, cuerpo y respuesta; semántica de los métodos HTTP: GET (lectura idempotente sin cuerpo), POST (creación con cuerpo), PUT (reemplazo total), PATCH (modificación parcial) y DELETE (eliminación); relación con CRUD; codigos de estado HTTP: familias 2xx (éxito), 4xx (error del cliente) y 5xx (error del servidor); distinción entre 200/201/204, 401/403 y 500/503; navegación de payloads JSON: objetos anidados, arrays y extracción de campos específicos

2. Herramientas cliente: Postman y curl Postman: configurar método, URL, cabeceras en la pestaña Headers y cuerpo en la pestaña Body (raw → JSON); cabecera Content-Type: application/json y cuándo incluirla; cabecera Authorization y sus formatos; curl: flags -X (método), -H (cabecera) y -d (cuerpo); diferencia entre usar comillas simples y dobles en distintos sistemas operativos; lectura de la respuesta con y sin flag -v (verbose) para ver cabeceras de respuesta

3. Query parameters y paginación Sintaxis de query string: ? para iniciar, = para asignar y & para separar múltiples parámetros; codificación de valores con espacios y caracteres especiales; parámetros de filtrado, ordenación y búsqueda: lectura de la documentación para identificar nombres y valores válidos; paginación offset-based: parámetros limit/offset y page/per_page; cálculo del número total de páginas con ceil(total / limit); metadatos de paginación: total, páginas, siguiente y anterior; limitaciones de la paginación offset-based con datos dinámicos

4. Petición integrada: filtrado, paginación y verificación de coherencia Construcción de una URL que combina parámetros de filtrado, ordenación y paginación sobre una API pública real; verificación activa de coherencia: contrastar docs.length con limit, offset declarado con offset enviado y total de resultados; detección de duplicados entre páginas usando identificadores únicos; identificación de comportamientos inesperados por inserción o eliminación de registros entre peticiones paginadas

• Postman (aplicación de escritorio) instalado
• Terminal con curl disponible (macOS/Linux nativo; Windows con Git Bash, WSL o el curl incluido en PowerShell)
• Navegador web actualizado
• Acceso a una API pública sin autenticación para los ejercicios (Open Library, JSONPlaceholder u otra indicada por el docente)

Ninguno requerido. El curso está orientado a perfiles técnicos con familiaridad básica con el navegador web y la terminal. No es necesario saber programar ni haber trabajado con APIs anteriormente.