Inteligencia Artificial Aplicada · IA-170

APIs para IA: JSON, claves y códigos de error

Qué es una API, cómo se lee un JSON y cómo se depura una llamada que devuelve error.

Disponible Iniciación 6 módulos · 24 clases

Formato asíncrono Desarrollo, Docentes FP Python, OpenAI

IA DESARROLLO

Lo que aprenderás

Explicar la anatomía de una petición HTTP: método, cabeceras, cuerpo y respuesta.
Recorrer un JSON anidado y extraer el campo concreto que interesa en cada caso.
Guardar una clave de API fuera del código y evitar que acabe publicada en un repositorio.
Interpretar los códigos 401, 429 y 500 y decidir qué hacer ante cada uno.
Realizar la primera llamada a la API de OpenAI desde Python y mostrar la respuesta.
Reintentar con espera creciente cuando el servicio limita la frecuencia de peticiones.

Contenido del curso

6 módulos · 24 clases en vídeo · práctica guiada en cada módulo

Módulo 1 · Presentación y entorno 4 clases

Qué es una API y por qué aparecen en todas partes
Preparar el cuaderno de trabajo en la nube
Cliente y servidor: quién pide y quién responde
Primera petición a una API pública sin clave

Módulo 2 · Anatomía de una petición 4 clases

Métodos GET y POST
Cabeceras: qué llevan y para qué
El cuerpo de la petición
Códigos de respuesta y qué significan

Módulo 3 · JSON sin misterio 4 clases

Estructura: objetos, listas y tipos de valor
Recorrer un JSON anidado paso a paso
Extraer el campo que interesa
Errores típicos: comillas, comas y valores nulos

Módulo 4 · Claves y seguridad básica 4 clases

Qué es una clave de API y qué permite hacer
Guardarla fuera del código y fuera del repositorio
Variables de entorno y secretos del cuaderno
Qué hacer si una clave se ha filtrado

Módulo 5 · Primera llamada a un modelo 4 clases

Instalar el cliente y autenticarse
Estructura de una petición al modelo
Leer la respuesta y extraer el texto
Parámetros básicos de la llamada

Módulo 6 · Depurar y caso práctico 4 clases

401, 429 y 500: causa y actuación
Reintentos con espera creciente
Leer la documentación de una API desconocida
Caso práctico: pequeño script que resuelve una tarea propia

Requisitos

Nociones mínimas de Python: variables, funciones, listas y diccionarios.
No se necesita experiencia previa con APIs, redes ni servicios web.
Basta con un navegador: las prácticas se hacen en cuadernos ejecutados en la nube.
Una clave de API de OpenAI para las llamadas reales del curso.

Descripción

Los tutoriales de integración con modelos empiezan asumiendo que se sabe qué es una cabecera, dónde va la clave y qué significa que el servidor conteste 429. Quien no viene del desarrollo web se queda en ese punto, con un ejemplo copiado que funciona o no funciona sin que quede claro por qué ni qué tocar cuando falla.

Este curso rellena ese hueco. Se explica qué es una API con ejemplos que se pueden inspeccionar, se lee y se recorre JSON hasta que deja de intimidar, se hace la primera llamada real a la API de OpenAI desde Python y, sobre todo, se practica la depuración: provocar errores a propósito y aprender a leer lo que el servidor responde.

También se trata desde el principio el manejo de claves, que es el error más frecuente y el más caro. Al terminar se puede leer la documentación de cualquier API y hacer la primera llamada sin ayuda. Es el paso previo natural al curso de integración con OpenAI y OpenRouter desde Google Colab.

¿Para quién es este curso?

Profesorado de FP de informática que debe explicar APIs en clase y quiere entenderlas a fondo primero.
Personas que empiezan en desarrollo y se atascan en la primera integración con un servicio externo.
Perfiles técnicos de otras áreas que necesitan automatizar una tarea llamando a un modelo.