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.
- Buscas el número de la pizzería en la agenda, porque te sabes el nombre, no el número.
- Llamas y haces el pedido con un formato que ambos entendéis: qué quieres, tamaño, dirección.
- La pizzería responde: «marchando», «no nos queda de esa» o «la cocina está cerrada».
- Llega el repartidor con la pizza (o no).
Internet funciona igual:
| Pizza | Internet |
|---|---|
| El nombre «Pizzería Luigi» | El dominio: example.com |
| Buscar el número en la agenda | El DNS traduce el dominio a una dirección IP, como 93.184.215.14 |
| El número de teléfono | La dirección IP del servidor |
| La extensión del departamento («pulse 2 para pedidos») | El puerto: 443, 80, 8000... |
| El formato del pedido | El protocolo HTTP |
| «Marchando», «no queda», «cerrado» | Los códigos de estado: 200, 404, 500 |
| La pizza | El 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:
httpses HTTP con cifrado (el candado del navegador).httpva 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
httpsy 80 parahttp. 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ódigo | Significado | En la pizzería |
|---|---|---|
| 200 OK | Todo bien, aquí tienes lo que pediste | «Marchando» |
| 404 Not Found | Eso no existe | «No tenemos esa pizza» |
| 401 Unauthorized | No sé quién eres o tu clave no vale | «Necesito tu número de socio» |
| 429 Too Many Requests | Demasiados pedidos seguidos | «Llama dentro de un rato, vamos a tope» |
| 500 Internal Server Error | El 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.htmlPaso 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 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 el404de 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 curl | https://example.com |
| Referencia de códigos de estado HTTP (MDN, en castellano) | https://developer.mozilla.org/es/docs/Web/HTTP/Status |
| Puertos reenviados en Codespaces | https://github.com/codespaces |
Errores frecuentes
| Síntoma | Qué pasa | Có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-WebRequest | En 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 Python | Al 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ágina | Has 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 reconoce | Python 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 navegador | localhost 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.