1. ¿Qué es una API REST? Principios Arquitectónicos y Restricciones de Roy Fielding
Comprende el concepto de interfaz de programación, la separación cliente-servidor, el modelo stateless (sin estado) y las restricciones que definen una verdadera arquitectura RESTful.
¿Qué es una API y por qué el Estilo REST domina la Web?
Una API (Application Programming Interface o Interfaz de Programación de Aplicaciones) es un conjunto de reglas, protocolos y definiciones que permite que dos sistemas de software independientes se comuniquen e intercambien datos de forma estructurada.
En el año 2000, Roy Fielding presentó en su tesis doctoral el estilo arquitectónico REST (Representational State Transfer o Transferencia de Estado Representacional). REST no es un protocolo ni una librería; es un conjunto de principios arquitectónicos diseñados para aprovechar al máximo las fortalezas del protocolo HTTP de la World Wide Web.
Desacoplamiento total entre interfaces de usuario (clientes) y lógica de persistencia (servidor).
Las Restricciones Fundamentales de una API RESTful
1. Separación Cliente-Servidor
La interfaz de usuario (React, Vue, iOS, Android) no debe saber nada sobre cómo se almacenan los datos en la base de datos MySQL; el servidor no debe preocuparse por cómo se renderiza la UI en la pantalla.
2. Sin Estado (Stateless)
El servidor no almacena sesiones del cliente en memoria. Cada petición HTTP debe contener en sí misma toda la información necesaria para ser autenticada y procesada (ej: mediante un Bearer Token JWT).
3. Capacidad de Caché (Cacheable)
Las respuestas deben indicar explícitamente mediante cabeceras HTTP si pueden ser cacheadas por clientes o proxies intermedios para reducir la latencia de red.
4. Interfaz Uniforme y Recursos
Cada entidad o dato se modela como un recurso identificado por una URI única y limpia (ej: /api/v1/usuarios, nunca /obtener_usuarios.php).
⚡ Servidor Mínimo de Ejemplo en PHP Puro que Devuelve JSON
Un script PHP básico que establece las cabeceras REST obligatorias y serializa datos estructurados a formato JSON:
<?php
declare(strict_types=1);
// 1. Establecer la cabecera indicando que la respuesta es JSON estándar
header('Content-Type: application/json; charset=utf-8');
// 2. Establecer el código de estado HTTP 200 OK
http_response_code(200);
// 3. Estructura de datos del recurso
$respuesta = [
'estado' => 'exito',
'mensaje' => 'API RESTful operativa en PHP Nativo',
'version' => '1.0.0',
'servidor' => [
'fecha' => date('Y-m-d H:i:s'),
'php_ver' => PHP_VERSION,
]
];
// 4. Serializar y emitir el JSON con opciones de formateo limpio
echo json_encode($respuesta, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué significa que una API REST sea "Stateless" (sin estado)?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar APIs RESTful con PHP Puro, JSON & JWT y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.