Con las herramientas de vuestro equipo
Conecta tus herramientas con APIs
Aprende a leer la documentación de una API, preparar una petición y comprender su respuesta para conectar las herramientas que ya usa tu equipo.
Antes de empezar
Haber construido un flujo sencillo y saber mapear campos, o experiencia equivalente. Antes de empezar acordamos las herramientas, el nivel y el entorno de aula; no hace falta programar. Los materiales permiten practicar sin conectar cuentas reales.
Elegimos el automatizador y los servicios según vuestro entorno. El caso descargable usa documentación y respuestas HTTP/JSON simuladas, sin claves ni cuentas reales. Si la edición incorpora ejecución en una herramienta, acordamos y comprobamos antes cuenta, plan, permisos, servicio de prueba y consumo. La revisión de archivos permite practicar el razonamiento, pero no acredita una conexión ejecutada.
Trabajamos técnicas y criterios que podéis aplicar con vuestras herramientas. Adaptamos los ejercicios al entorno que utilice vuestro equipo y confirmamos las funciones, los accesos y el consumo necesarios para la práctica acordada.
Ver preparación y condiciones →Al terminar podrás
- 01
Interpretar un endpoint, sus parámetros y la respuesta JSON que devuelve.
- 02
Preparar un mapeo que conserve identificadores y distinga un dato ausente.
- 03
Reconocer autenticación, paginación, límites y errores para decidir el siguiente paso.
- 04
Justificar cuándo usar un conector, una petición HTTP o ayuda técnica.
Qué trabajaremos
Cuando un conector se queda corto, la documentación de una API ayuda a entender qué se puede consultar y qué hace falta para hacerlo. Trabajaremos con un caso de pedidos pendientes: leer la petición, recorrer la respuesta y dejar claras las excepciones antes de elegir cómo conectar.
01Entender la petición y la respuesta
Documentación del endpoint, método, parámetros, campos JSON y datos que faltan. De la necesidad del equipo a una petición acotada.
Trabajarás en
- Traducir la necesidad de revisar pedidos pendientes a un endpoint y sus parámetros.
- Distinguir método, ruta y consulta de los campos que devuelve el servidor.
- Mapear identificador, estado y fecha de entrega sin convertir un dato ausente en una fecha inventada.
- Práctica
- Leer la referencia de la API de aula y completar el mapeo de la primera página de pedidos.
- Cómo lo comprobarás
- Una petición coherente con la documentación y un mapeo donde cada campo tiene origen y regla.
02Acceder y recorrer los datos
Autenticación sin compartir credenciales, páginas de resultados y límites de consulta. Qué comprobar antes de dar el listado por completo.
Trabajarás en
- Identificar qué autenticación pide el servicio y quién debe preparar el acceso, sin copiar secretos en materiales.
- Seguir el cursor de la segunda página manteniendo el filtro y comprobar cuándo termina la consulta.
- Distinguir el tamaño de página del límite de peticiones y registrar qué datos faltan.
- Práctica
- Combinar las dos respuestas simuladas en un listado de tres pedidos y conservar una fecha sin confirmar.
- Cómo lo comprobarás
- Tres identificadores únicos, las dos páginas registradas y una consulta marcada como completa solo al terminar el recorrido.
03Diagnosticar y elegir cómo conectar
Respuestas de error, reintentos limitados y documentación útil para continuar. Elegir conector, HTTP o una intervención técnica según el caso.
Trabajarás en
- Diferenciar una credencial no válida, un límite de peticiones y un error del servicio.
- Elegir una respuesta limitada y documentar cuándo parar y pedir intervención.
- Comparar un conector disponible, una petición HTTP y desarrollo adicional según lo que admite la documentación.
- Práctica
- Revisar 401, 429 y 500 y preparar una decisión de conexión con responsable, pruebas y asuntos pendientes.
- Cómo lo comprobarás
- Un registro que explica cada error y el siguiente paso, sin reintentos indefinidos ni promesas de integración.
Tres pedidos, dos páginas y una fecha pendiente.
Ejemplo de aula con datos ficticios
Consultarás pedidos pendientes de un proveedor ficticio a partir de documentación, peticiones y respuestas simuladas. Prepararás el listado de dos páginas y resolverás un dato sin confirmar y tres respuestas de error. El automatizador y los servicios reales se eligen para cada edición.
Caso ficticio de aula. Operaciones necesita revisar los pedidos pendientes de un proveedor. El conector disponible no ofrece esa consulta. La API del ejercicio devuelve dos páginas; un pedido no tiene fecha de entrega confirmada. Usamos archivos preparados, sin servidor ni cuentas reales.
- Punto de partida
- La primera página muestra dos pedidos y un cursor para continuar. Darla por completa dejaría fuera el tercer pedido.
- Primera lectura
- El primer intento conserva solo la primera página y rellena la fecha vacía con la fecha de otro pedido.
- Qué revisamos
- Revisa next_cursor antes de cerrar la consulta y conserva cada identificador. La fecha ausente debe quedar sin confirmar; después explica cómo actuarías ante autenticación incorrecta, límite de peticiones y error del servicio.
- Resultado
- La solución de aula reúne ORD-101, ORD-102 y ORD-103. ORD-102 conserva la fecha sin confirmar y el registro distingue terminar la paginación de detenerse por un error.
Comprobar antes de concluir.
La primera página no es todo el listado
Antes de revisar
Dos pedidos; ORD-102 toma una fecha de otro registro.
Después de revisar
Tres pedidos de dos páginas; ORD-102 queda sin confirmar.
El cursor indica que hay más resultados. Un valor null no autoriza completar el dato.
Tres errores, tres decisiones distintas
Revisamos las respuestas simuladas AUTH-401, RATE-429 y ERROR-500 de una consulta de lectura. No son resultados de llamadas reales.
| Respuesta del caso | Qué comprobamos | Decisión esperada |
|---|---|---|
| 401 · AUTH-401 | La respuesta indica un problema de autenticación. Conocer el endpoint no acredita acceso. | Parar y revisar el acceso con su responsable, sin copiar claves ni repetir la consulta de forma automática. |
| 429 · RATE-429 | El encabezado Retry-After del caso indica 30 segundos. | Respetar la espera. Solo si está permitido repetir la lectura, mantener un máximo de dos intentos totales, incluido el inicial. |
| 500 · ERROR-500 | El servidor devuelve un error; conservamos petición, estado y contexto. | Aplicar solo el tratamiento limitado acordado para lectura. Si persiste, parar y escalar; no crear un bucle de reintentos. |
Desliza para ver todas las columnas.
Un mismo botón de «reintentar» no resuelve los tres casos: la evidencia debe justificar la siguiente acción y quién se hace cargo.
Qué no podemos concluir
- Las decisiones corresponden al contrato y al límite de este ejercicio. En una integración real se revisan la documentación, los permisos y la política de reintentos del servicio.
- Revisar archivos demuestra el diagnóstico previsto; no acredita una conexión ni una ejecución real.
Antes de darlo por terminado
- El listado contiene los tres identificadores una sola vez y registra las dos páginas.
- La fecha ausente de ORD-102 sigue sin confirmar; no se toma de otro pedido.
- La decisión de conexión explica acceso, límites, errores y cuándo debe intervenir otra persona.
Sesiones para llevarlo a la práctica.
Edición de referencia · 4 h en directo
Edición de referencia: 4 horas en directo, en 2 sesiones de 2 horas. Práctica, evidencia individual y feedback breve se realizan dentro de las sesiones; no se añaden tareas obligatorias entre ellas.
- Sesión 12 h
Leer y preparar una consulta
Del problema al endpoint: método, parámetros, respuesta JSON, mapeo y preparación del acceso. Practicamos sobre los archivos simulados del caso.
Al terminarUna ficha de petición y un mapeo revisado, con datos ausentes y requisitos de acceso visibles.
- Sesión 22 h
Completar, diagnosticar y decidir
Recorrer dos páginas, resolver respuestas de error y decidir conector, HTTP o ayuda técnica. La evidencia individual y el feedback se realizan en la sesión.
Al terminarUn listado contrastado y una decisión de conexión documentada, con límites y siguiente responsable.
Si vuestro equipo necesita ir más allá
- Esta ampliación tiene 4 horas propias; no sustituye las horas de una formación inicial de automatización.
- OAuth avanzado, firma de peticiones, conectores personalizados y desarrollo de una API requieren otro alcance.
- Integraciones productivas, datos reales y consumo de servicios se acuerdan aparte; ninguna plataforma está predeterminada.
Una evidencia individual para cerrar.
Completa individualmente una ficha de petición, el listado de pedidos y una decisión de conexión. Justifica un dato pendiente y la respuesta a un error; el docente revisa la evidencia y da feedback dentro de las 4 horas.
Preparar la petición
- Apto
- Identifica método, ruta y parámetros a partir de la referencia, y distingue el acceso requerido sin copiar una clave.
- Por revisar
- La petición no responde a la necesidad o confunde un parámetro con un campo de salida.
Conservar y completar los datos
- Apto
- Reúne ambas páginas, conserva los tres identificadores y deja la fecha ausente sin confirmar.
- Por revisar
- Omite una página, repite un identificador o inventa la fecha de ORD-102.
Diagnosticar con límites
- Apto
- Distingue 401, 429 y 500, justifica una respuesta limitada y sabe cuándo parar y escalar.
- Por revisar
- Reintenta sin límite, cambia permisos sin responsable o interpreta un error como consulta vacía.
Elegir y explicar el siguiente paso
- Apto
- Justifica conector, HTTP o ayuda técnica con evidencia de la documentación y asuntos pendientes.
- Por revisar
- Elige por preferencia de marca o promete una integración que no se ha comprobado.
El docente revisa la tarea y explica el resultado dentro del tiempo previsto. Una recuperación adicional se acuerda para cada edición.
Aprender con alguien que desarrolla proyectos para empresas.
Borja Martínez
Consultor de The Optimal Flow
Más de dos años de experiencia desarrollando proyectos para empresas de todas las industrias y tamaños.
Borja es el docente previsto por área. La preparación del caso, el entorno, las fechas y su disponibilidad se confirman al acordar la edición.
Un caso para entender la conexión.
Documentación, peticiones y respuestas simuladas, hojas vacías y ejemplos resueltos para practicar sin cuentas reales.
- Guía de práctica y tiempos
- Referencia de la API ficticia
- Peticiones simuladas
- Respuestas simuladas HTTP/JSON
- Mapeo vacío
- Ejemplo de mapeo resuelto
- Listado vacío de pedidos
- Ejemplo de listado resuelto
- Registro de pruebas vacío
- Ejemplo de pruebas resuelto
- Decisión de conexión vacía
- Ejemplo de decisión resuelto
- Comprobaciones y solución
Con guía, práctica y acompañamiento.
Cada edición incluye materiales de trabajo, feedback sobre la práctica y evaluación según los objetivos acordados.
Materiales que podéis conservar
Guía, ejercicios y criterios de revisión descargables y versionados, para uso interno.
Para preparar y cerrar la edición
Recomendación breve, kit editable de comunicación e informe de aprendizaje del grupo.
Diploma propio de TOF
De aprovechamiento, al superar la evaluación acordada. No es una certificación del fabricante.
Un mes de soporte por correo
Sobre lo trabajado en clase, hasta dos horas acumuladas para todo el grupo.
La práctica la realiza tu equipo. Los servicios de implantación se acuerdan aparte. Ver el alcance →