Itinerario AI Builder · Semana 0 · Para empezar

PE03: Qué pasa cuando abres una web

Desde cero⏱ 40-60 min

Objetivos

  • Explicar con un ejemplo cotidiano qué son una URL, el DNS y una petición HTTP.
  • Entender qué significan localhost y un puerto, y por qué tu app vive en http://localhost:8000.
  • Leer los códigos de estado más comunes: 200, 404, 401, 429 y 500.
  • Levantar un servidor web en tu ordenador con python -m http.server y abrirlo en el navegador.
  • Hacer una petición con curl y reconocer el error de puerto ocupado.

Antes de empezar: pe01 terminado (Python y terminal funcionando) o un Codespace abierto. No hace falta ninguna cuenta.

Prompt de arranque

Nunca he programado. Explícame con una analogía de la vida diaria qué pasa
desde que escribo una dirección web en el navegador hasta que veo la página.
Después dame el comando exacto para levantar un servidor web de prueba en mi
ordenador con Python (uso [Windows 11 / macOS / Ubuntu]) y el comando curl
para hacerle una petición y ver la respuesta completa con sus cabeceras.

Esto lo escribe la IA, tú compruebas que funciona. Hoy no escribes ni una línea de código: Python ya trae un servidor web y solo hay que encenderlo.

Explicación

Por qué un builder necesita entender Internet

Todo lo que vas a construir en el itinerario habla por Internet: tu script le pregunta a la IA por Internet (pe04), tu backend responde por Internet (pe05) y casi todos los errores que verás (401, 404, 429, 500) son mensajes de Internet (pe06). Si entiendes cómo viaja una petición, esos errores dejan de ser misteriosos y pasan a ser pistas.

La analogía: pedir comida a domicilio

Imagina que pides una pizza por teléfono.

  1. Buscas el número de la pizzería en la agenda, porque te sabes el nombre, no el número.
  2. Llamas y haces el pedido con un formato que ambos entendéis: qué quieres, tamaño, dirección.
  3. La pizzería responde: «marchando», «no nos queda de esa» o «la cocina está cerrada».
  4. Llega el repartidor con la pizza (o no).

Internet funciona igual:

PizzaInternet
El nombre «Pizzería Luigi»El dominio: example.com
Buscar el número en la agendaEl DNS traduce el dominio a una dirección IP, como 93.184.215.14
El número de teléfonoLa dirección IP del servidor
La extensión del departamento («pulse 2 para pedidos»)El puerto: 443, 80, 8000...
El formato del pedidoEl protocolo HTTP
«Marchando», «no queda», «cerrado»Los códigos de estado: 200, 404, 500
La pizzaEl contenido: una página HTML, un JSON, una imagen

Anatomía de una URL

Una URL es la dirección completa de algo en Internet. Fíjate en esta:

https://www.ejemplo.com:443/cursos/empezar?nivel=cero
└─┬─┘   └──────┬──────┘└┬┘└──────┬──────┘└────┬────┘
protocolo    dominio   puerto   ruta      parámetros
  • Protocolo: https es HTTP con cifrado (el candado del navegador). http va sin cifrar; está bien para pruebas en tu propio ordenador, nunca para datos reales en Internet.
  • Dominio: el nombre fácil de recordar.
  • Puerto: casi nunca lo ves porque se sobrentiende: 443 para https y 80 para http. En tus pruebas sí lo verás, porque usarás otros, como el 8000.
  • Ruta: qué parte del sitio quieres.
  • Parámetros: detalles extra del pedido, después del ?.

El DNS: la agenda de Internet

Los ordenadores se localizan por números (direcciones IP), pero las personas recordamos nombres. El DNS (sistema de nombres de dominio) es la agenda gigante que traduce example.com a su número. Tu ordenador consulta esa agenda cada vez que escribes un dominio nuevo. Si el DNS falla, el navegador dice algo como «No se ha podido encontrar la dirección IP del servidor»: el equivalente a no encontrar el número en la agenda.

HTTP: el formato del pedido

HTTP es el idioma en que se hablan el navegador (el cliente, el que pide) y el servidor (el que responde). Cada conversación es una petición seguida de una respuesta.

La petición lleva un método, que es el tipo de pedido:

  • GET: «dame esto». Es lo que hace el navegador al abrir una página.
  • POST: «toma esto y haz algo con ello». Es lo que hará tu script de pe04 al enviar una pregunta a la IA.

La respuesta empieza con un código de estado, un número de tres cifras que resume cómo ha ido:

CódigoSignificadoEn la pizzería
200 OKTodo bien, aquí tienes lo que pediste«Marchando»
404 Not FoundEso no existe«No tenemos esa pizza»
401 UnauthorizedNo sé quién eres o tu clave no vale«Necesito tu número de socio»
429 Too Many RequestsDemasiados pedidos seguidos«Llama dentro de un rato, vamos a tope»
500 Internal Server ErrorEl servidor ha fallado«Se nos ha quemado el horno»

Una regla para recordar: los 4xx son culpa del cliente (has pedido mal) y los 5xx son culpa del servidor (él ha fallado). Saber esto te ahorra horas: ante un 401 revisas tu clave; ante un 500, el problema está en el otro lado (o en tu backend, cuando el servidor seas tú).

Además del código, la respuesta trae cabeceras (datos sobre la respuesta: tipo de contenido, tamaño, fecha) y el cuerpo (el contenido en sí).

localhost: tu ordenador hablando consigo mismo

Hasta ahora el servidor estaba lejos. Pero tu propio ordenador también puede ser servidor. Para eso existe un nombre especial: **localhost**, que siempre significa «este mismo ordenador». Su dirección IP es 127.0.0.1.

Es como llamarte a tu propio móvil desde el fijo de casa: la llamada no sale de casa. Por eso localhost es perfecto para probar: nadie más puede verlo, no cuesta nada y no hace falta Internet.

Los puertos: las puertas del edificio

Un ordenador puede tener muchos servidores a la vez. Para no mezclarlos, cada uno escucha en un puerto, un número entre 1 y 65535. Si tu ordenador es un edificio, localhost es la dirección y el puerto es el número de la puerta. Tu servidor de hoy escuchará en la puerta 8000, así que su dirección completa será http://localhost:8000.

Dos reglas prácticas:

  • Solo un programa por puerto. Si intentas encender otro servidor en una puerta ocupada, sale el error «Address already in use» (dirección ya en uso). Se arregla parando el primero o usando otro número.
  • Los puertos bajos (por debajo de 1024) están reservados y piden permisos de administrador. Para pruebas, usa números como 8000, 8080 o 3000.

curl: hacer peticiones desde la terminal

El navegador hace peticiones y te enseña el resultado bonito. **curl** hace lo mismo desde la terminal, pero te enseña la respuesta en bruto: código de estado, cabeceras y cuerpo. Es el estetoscopio del builder: cuando algo falla, curl te dice qué está respondiendo de verdad el servidor. Viene instalado en Windows 11, macOS y Ubuntu (en Windows hay un matiz: se escribe curl.exe, lo verás en el lab).

Codespaces: el localhost que está en otro sitio

Si trabajas en Codespaces, tu «ordenador» está en la nube. Cuando enciendes un servidor allí, VS Code detecta el puerto y te ofrece abrirlo con un botón Open in Browser (Abrir en el navegador). La dirección no será localhost, sino una del tipo https://<nombre>-8000.app.github.dev. Por dentro es lo mismo: GitHub hace de puente entre tu navegador y el puerto 8000 de tu Codespace. Ese puerto es privado por defecto: solo tú puedes abrirlo.

Lab paso a paso

Objetivo: encender un servidor web en tu ordenador, ver una página tuya en el navegador, provocar un 404 y un error de puerto ocupado, y leer las respuestas con curl.

Paso 1. Una página web mínima

Crea la carpeta y una página de una línea.

Windows (PowerShell)

mkdir $HOME\lab\web
cd $HOME\lab\web
Set-Content -Path index.html -Value '<h1>Hola, soy mi primera web</h1>' -Encoding utf8

macOS, Ubuntu y Codespaces

mkdir -p ~/lab/web
cd ~/lab/web
echo '<h1>Hola, soy mi primera web</h1>' > index.html

Paso 2. Encender el servidor

Windows

python -m http.server 8000 --bind 127.0.0.1

macOS, Ubuntu y Codespaces

python3 -m http.server 8000

Qué debe verse:

Serving HTTP on :: port 8000 (http://[::]:8000/) ...

(En Windows, con --bind 127.0.0.1, verás Serving HTTP on 127.0.0.1 port 8000). La terminal se queda «colgada»: es normal, el servidor está esperando pedidos. No la cierres.

Paso 3. Abrirlo en el navegador

Abre http://localhost:8000 en el navegador. Debe verse el titular «Hola, soy mi primera web». En la terminal del servidor aparece una línea por cada petición:

::1 - - [11/Oct/2026 10:15:02] "GET / HTTP/1.1" 200 -

Léela: alguien desde tu propio ordenador (::1 es localhost en formato IPv6) pidió con GET la ruta / y recibió un 200.

En Codespaces, pulsa Open in Browser en el aviso que aparece abajo a la derecha, o abre la pestaña Ports (Puertos) y el icono del globo junto al 8000.

Paso 4. Provocar un 404

Abre http://localhost:8000/no-existe. El navegador muestra «Error response. Error code: 404». En la terminal del servidor verás code 404, message File not found. Has pedido una pizza que no está en la carta.

Paso 5. La misma petición con curl

Abre una segunda terminal (deja la del servidor encendida). En VS Code: menú Terminal > New Terminal.

Windows (escribe curl.exe, no curl)

curl.exe -i http://localhost:8000/
curl.exe -s -o NUL -w "%{http_code}`n" http://localhost:8000/no-existe

macOS, Ubuntu y Codespaces

curl -i http://localhost:8000/
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8000/no-existe

Qué debe verse en la primera orden (las fechas y la versión cambian):

HTTP/1.0 200 OK
Server: SimpleHTTP/0.6 Python/3.13.x
Date: Sun, 11 Oct 2026 08:15:02 GMT
Content-type: text/html
Content-Length: 34
Last-Modified: Sun, 11 Oct 2026 08:14:40 GMT

<h1>Hola, soy mi primera web</h1>

Primera línea: el código de estado. Después, las cabeceras. Tras la línea en blanco, el cuerpo. La segunda orden solo imprime el código: 404.

Paso 6. Una petición a Internet de verdad

curl -I https://example.com

(En Windows, curl.exe -I https://example.com). La opción -I pide solo las cabeceras. Debe verse HTTP/2 200 y una lista de cabeceras. Tu ordenador ha consultado el DNS, ha encontrado el servidor y le ha pedido la página por https.

Paso 7. Provocar el error de puerto ocupado

Con el servidor aún encendido, en la segunda terminal intenta encender otro en el mismo puerto (python -m http.server 8000 en Windows, python3 -m http.server 8000 en macOS y Linux). Debe verse un error que termina así:

OSError: [Errno 48] Address already in use          ← macOS
OSError: [Errno 98] Address already in use          ← Ubuntu
OSError: [WinError 10048] Solo se permite un uso de cada dirección de socket...   ← Windows

Solución: usa otro puerto (8001) o para el primer servidor.

Paso 8. Apagar el servidor

En la terminal del servidor, pulsa Ctrl + C. Vuelve a abrir http://localhost:8000: ahora el navegador dice «No se puede acceder a este sitio» o «Connection refused». No hay nadie en esa puerta.

Evidencia

  • Captura del navegador con http://localhost:8000 mostrando tu página.
  • Captura de la terminal con la salida de curl -i http://localhost:8000/ (código 200, cabeceras y cuerpo) y el 404 de la segunda orden.

Criterio de aceptación

URLs de activación

Esta unidad no necesita ninguna cuenta. Verificadas el 11-10-2026.

Para quéURL
Tu servidor local (solo funciona con el servidor encendido)http://localhost:8000
Página de ejemplo para probar curlhttps://example.com
Referencia de códigos de estado HTTP (MDN, en castellano)https://developer.mozilla.org/es/docs/Web/HTTP/Status
Puertos reenviados en Codespaceshttps://github.com/codespaces

Errores frecuentes

SíntomaQué pasaCómo se arregla
OSError: [Errno 48] Address already in use (o Errno 98, o WinError 10048)Ya hay un programa escuchando en ese puerto, a menudo un servidor que dejaste encendido en otra terminal.Busca la terminal del primer servidor y pulsa Ctrl + C, o usa otro puerto: python3 -m http.server 8001.
En Windows, curl -i ... da un error en rojo sobre Invoke-WebRequestEn Windows PowerShell 5.1, curl es un alias de otro comando (Invoke-WebRequest) con opciones distintas.Escribe siempre curl.exe, que es el curl real incluido en Windows 11.
En Windows sale una ventana del Firewall preguntando si permitir PythonAl escuchar en todas las direcciones, Windows pregunta si abrir la red.Usa --bind 127.0.0.1 (como en el lab) y no hará falta. Si ya salió, pulsa «Cancelar»: para localhost no necesitas permiso de red.
El navegador dice «No se puede acceder a este sitio» o «Connection refused»El servidor no está encendido, lo apagaste con Ctrl + C o estás usando otro puerto.Comprueba que la terminal del servidor muestra «Serving HTTP» y que el número de la URL coincide con el del comando.
Sale el listado de ficheros en vez de tu páginaHas encendido el servidor en otra carpeta, o index.html tiene otro nombre (por ejemplo, index.html.txt).Para el servidor, entra en ~/lab/web con cd y vuelve a encenderlo. Comprueba el nombre con ls o Get-ChildItem.
python3: command not found o python no se reconocePython no está en el PATH, o estás usando el nombre del otro sistema.En Windows usa python; en macOS y Linux, python3. Si sigue fallando, vuelve a pe01.
En Codespaces, http://localhost:8000 no abre en tu navegadorlocalhost es tu portátil, no el Codespace.Usa el botón Open in Browser o la pestaña Ports.

Quiz

Cinco preguntas para comprobar que lo has entendido. Necesitas un 70 % para aprobar.