API en Next.js · Paso 4 de 9
Conceptos básicos de HTTP
Petición y respuesta, métodos como GET o POST, códigos de estado y por qué JSON es el formato habitual en APIs modernas.
HTTP es el protocolo que usa el navegador (y muchas apps) para hablar con un servidor: cada acción es una petición y casi siempre recibes una respuesta.
No tienes que saber todo el estándar de memoria. Con cuatro ideas (petición/respuesta, método, código de estado y cuerpo en JSON) ya puedes seguir el curso con claridad.
Petición y respuesta
Una petición lleva, entre otras cosas, una URL (a qué recurso llamas) y un método (qué tipo de acción es: leer, crear, etc.).
La respuesta incluye un código de estado (resumen en un número: ¿todo bien?, ¿no encontrado?, ¿error del servidor?) y a menudo un cuerpo con datos, por ejemplo JSON.
Métodos que verás al principio
GET — «trae esto». Se usa para leer datos. No debería cambiar nada en el servidor por sí solo (por eso puedes refrescar o compartir el enlace).
POST — «envía esto». Se usa para crear algo o enviar un formulario; el cuerpo de la petición lleva la información.
Códigos de estado (una pista rápida)
2xx — salió bien (el clásico 200 OK).
4xx — problema con lo que pidió el cliente (404 no existe ese recurso, 400 datos inválidos, etc.).
5xx — problema en el servidor (500 error interno).
En el navegador, las herramientas de desarrollo (pestaña Network) te muestran método, URL, código y cuerpo: es tu mejor amiga para depurar.
JSON
JSON es un formato de texto para datos estructurados (objetos y listas). Es ligero y casi todo el mundo lo entiende: por eso las APIs REST suelen responder JSON.
Ejemplo mínimo: { "hola": "mundo" }. En la siguiente lección verás JSON real saliendo de tu propio endpoint en Next.js.
Cliente
Servidor
Petición — GET /api/ejemplo
El cliente «llama» al recurso en el servidor
Respuesta — 200 y cuerpo JSON
El servidor devuelve estado y datos
Idea visual: el cliente envía una petición (por ejemplo GET); el servidor responde con un código (200) y un cuerpo en JSON.
Cuando hayas leído el texto, marca la lección para seguir el progreso.