# Conecta tus herramientas con APIs · guía de práctica

Versión 1 · Material docente original · Caso ficticio · ES

## Qué vas a preparar

Una ficha de petición, un mapeo, el listado completo de pedidos pendientes y una decisión de conexión. Trabajarás con archivos: no hay un servidor, cuentas reales ni una automatización importable. El método se puede trasladar al automatizador y servicios acordados para la edición; el acceso y la ejecución se comprueban por separado.

Necesitas experiencia con un flujo sencillo y mapeo de campos, o equivalente. No necesitas programar. Puedes abrir JSON, HTTP y Markdown con un editor de texto y CSV con una hoja de cálculo. Si el acceso o un formato te bloquea, registra el problema: el docente acuerda una alternativa textual, sin afirmar que has ejecutado una conexión.

## El encargo

Operaciones revisa a diario pedidos pendientes de un proveedor ficticio. Su conector disponible no ofrece esa consulta. La documentación de aula permite una petición de lectura, dos páginas y tres campos. Debes conservar cada identificador, indicar qué falta y explicar cómo actuar ante un error. No se envían avisos, hacen compras ni cambian registros.

## Sesión 1 · 120 minutos

| Minutos | Actividad |
|---:|---|
| 10 | Acordar necesidad y límites del caso |
| 25 | Leer `api-reference.md`: endpoint, método y parámetros |
| 30 | Revisar `requests.http` y `responses.json`; completar `mapping-blank.csv` |
| 5 | Pausa |
| 25 | Identificar autenticación y preparación del acceso, sin introducir secretos |
| 15 | Revisar el mapeo individual y recibir feedback breve |
| 10 | Recapitular qué puede y qué no puede concluirse de la primera página |

Lee primero la referencia. Distingue ruta y parámetros de los campos de salida. Explica por qué GET responde al encargo de consulta y por qué no necesitas un cuerpo de petición en este contrato. Completa una regla para `id`, `status` y `delivery_date`. Localiza el valor null: es distinto de una fecha y no permite copiar la de otro pedido.

La autenticación del ejemplo se comenta de forma conceptual. No pegues claves ni contraseñas en las hojas. Identifica quién comprobaría el servicio, su método de acceso y el almacenamiento de credenciales del automatizador elegido. El error 401 preparado permite discutir qué harías si el acceso no fuera válido, sin crear ni solicitar una credencial real.

## Sesión 2 · 120 minutos

| Minutos | Actividad |
|---:|---|
| 10 | Recuperar el encargo y revisar una petición |
| 25 | Seguir `next_cursor` y completar `orders-blank.csv` |
| 30 | Revisar 401, 429 y 500 con `tests-blank.csv` |
| 5 | Pausa |
| 25 | Completar `decision-blank.md`: conector, HTTP o ayuda técnica |
| 20 | Evidencia individual, contraste y feedback |
| 5 | Registrar el siguiente paso y cerrar |

Sigue el cursor de OK-1 usando la petición `page_2`. Mantén `status=pending` y `limit=2`. La segunda página termina con `next_cursor: null`. Combina las páginas por identificador; el tamaño de página no es el total de pedidos ni el límite de peticiones por tiempo.

Anota resultado esperado y respuesta ante cada error antes de mirar el ejemplo resuelto. Un 401 requiere revisar acceso con su responsable; un 429 pide respetar la espera y el límite acordado; un 500 no se arregla modificando los datos a ciegas. En esta simulación, cualquier reintento de consulta tiene un máximo de dos intentos totales, contando el inicial; si persiste el error, se detiene y escala. No configures bucles ni ejecutes llamadas.

Revisa también FORMAT-200: un 200 no basta si la estructura no cumple el contrato. Ese caso no es una lista vacía válida. Por último, explica qué podría cubrir un conector, qué requiere HTTP y qué necesita desarrollo o información del proveedor.

## Entrega y revisión

Entrega tu mapeo, listado, registro de pruebas y decisión. Explica un dato pendiente y un error con referencia al archivo. El docente valora: petición coherente; listado completo y datos preservados; diagnóstico limitado; decisión justificada. El feedback está dentro de las cuatro horas. No hay tarea obligatoria entre sesiones ni otra evaluación fuera del tiempo aprobado.

`expected.md` y los archivos `worked-example` son soluciones ficticias de autocorrección, no evidencias de alumnos ni ejecuciones realizadas. Consulta las soluciones después de tu intento. Si falta algo, corrige el material y explica por qué.

## Antes de trasladarlo a una herramienta

Cliente y docente acuerdan automatizador, servicio, cuenta de prueba, plan, permisos y consumo. Se comprueban documentación vigente y soporte del endpoint; no se presupone que todas las plataformas funcionan igual. Si solo se revisan estos archivos, la evidencia es de razonamiento sobre HTTP/JSON: no de conexión ejecutada. La preparación o implantación productiva tiene otro alcance.

Pendiente interno: ensayo docente de claridad, tiempos y preparación antes de una edición real.

[Descargar paquete ZIP](api-es-v1.zip)