¿Dónde está mi compra?
Abres la aplicación del supermercado para ver si tu compra ya ha salido.
El móvil no sabe nada de tu pedido. Le pregunta a un servidor y espera la contestación.
Esa pregunta y esa contestación tienen siempre la misma forma. Si la sabes leer, entiendes casi cualquier fallo de una aplicación.
Al final de esta lección
Nota
Puedo decir qué son una petición y una respuesta.
Palabras clave
| Palabra | Qué significa | Ejemplo |
|---|---|---|
| Petición | mensaje que un programa envía a un servidor | |
| Respuesta | mensaje que el servidor devuelve | |
| API | direcciones que un programa ofrece a otros programas | |
| URL | dirección de un recurso en la web | https://api.supermercado.example/pedidos/1043 |
| Código de estado | número que dice cómo fue la petición | 404 |
| Cabecera | dato extra sobre el mensaje |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.
Cada petición recibe una respuesta
Un programa, como la aplicación del móvil, se llama cliente. Envía una petición a un servidor.
La petición dice qué quiere y dónde está. El servidor la lee, busca los datos y devuelve una respuesta.
Una petición, una respuesta. Así funciona cada pantalla que carga una aplicación.
Una URL es una dirección por partes
Una URL dice al cliente adónde ir y qué pedir. Se lee de izquierda a derecha.
Primero va el protocolo, después el servidor y al final la ruta. A veces lleva una consulta detrás de ?.
Ejemplo resuelto: las partes de una URL
| Parte | En el ejemplo | Qué indica |
|---|---|---|
| Protocolo | https | Las reglas del mensaje, con cifrado |
| Servidor | api.supermercado.example | A qué máquina se pregunta |
| Ruta | /pedidos/1043 | Qué recurso se quiere |
| Consulta | ?ciudad=valencia | Un filtro opcional |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.
El método dice qué quieres hacer
Cada petición lleva un método. Es un verbo que dice qué quiere hacer el cliente.
GET pide datos. POST crea algo nuevo. PUT cambia algo que ya existe. DELETE lo borra.
La misma URL con otro método hace otra cosa.
El código de estado resume la respuesta
Toda respuesta empieza con un número de tres cifras. La primera cifra ya te dice mucho.
Un 2 significa que todo fue bien. Un 4 significa que la petición tiene un problema. Un 5 significa que el servidor ha fallado.
Ejemplo resuelto: respuestas reales
| Petición | Código | Qué significa |
|---|---|---|
| GET /pedidos/1043 | 200 OK | Aquí tienes el pedido |
| POST /pedidos | 201 Created | Pedido creado |
| GET /pedidos/9999 | 404 Not Found | Ese pedido no existe |
| GET /mis-datos sin iniciar sesión | 401 Unauthorized | Primero di quién eres |
| GET /pedidos con el servidor roto | 500 Internal Server Error | Fallo dentro del servidor |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.
Un error frecuente
Advertencia
Mucha gente cree que un 404 significa que el servidor está caído. Un 404 significa que el servidor contesta, pero no encuentra esa dirección. Si el servidor falla, el código empieza por 5.
Las cabeceras hablan del mensaje
Debajo del código vienen las cabeceras. Cada una es un nombre, dos puntos y un valor.
Content-Type dice qué formato tienen los datos. Date dice cuándo se respondió.
Después de una línea en blanco llega el cuerpo: los datos que pediste. La herramienta curl te enseña todo esto en la terminal.
Dos respuestas reales leídas con curl
# -i pide que se muestren también las cabeceras.
$ curl -i https://api.supermercado.example/pedidos/1043
HTTP/1.1 200 OK
Content-Type: application/json
Date: Mon, 12 Oct 2026 09:15:02 GMT
Cache-Control: no-store
{"id": 1043, "status": "en reparto", "total": 23.40}
# La misma petición con un pedido que no existe.
$ curl -i https://api.supermercado.example/pedidos/9999
HTTP/1.1 404 Not Found
Content-Type: application/json
{"error": "No existe ese pedido"}
Lo que espera quien te contrata
Consejo
En soporte, en pruebas y en desarrollo te preguntarán qué código devolvió una petición. Saber si el fallo está en el cliente o en el servidor ahorra horas a tu equipo.