Qué es una API REST y cómo consumirla desde PHP
Foto: Farzad Nazifi euwars · CC0 · Redimensionada
Cuando su tienda virtual consulta la tasa de cambio, cuando un sitio muestra un mapa o cuando una aplicación cobra con tarjeta, detrás hay una API. Entender cómo funcionan es fundamental para cualquier desarrollador web.
¿Qué es una API?
API significa Interfaz de Programación de Aplicaciones. Es un conjunto de reglas que permite que dos programas se comuniquen. Una analogía útil: la API es el mesero de un restaurante. Usted (la aplicación) hace un pedido, el mesero lo lleva a la cocina (el servidor) y le trae la respuesta.
Foto: By StartupStockPhotos · CC0 · Recortada¿Qué significa REST?
REST es un estilo de diseño de APIs que usa el protocolo HTTP, el mismo de la web. Cada recurso tiene una dirección (URL) y se manipula con métodos HTTP:
- GET: consultar datos.
GET /productos/15 - POST: crear un registro.
POST /productos - PUT o PATCH: actualizar.
PUT /productos/15 - DELETE: eliminar.
DELETE /productos/15
Las respuestas suelen venir en formato JSON, un formato de texto fácil de leer para personas y máquinas:
{
"id": 15,
"nombre": "Camiseta",
"precio": 45000,
"disponible": true
}
El servidor también devuelve un código de estado: 200 (correcto), 201 (creado), 400 (solicitud incorrecta), 401 (no autorizado), 404 (no encontrado) o 500 (error del servidor).
Consumir una API desde PHP
Con la extensión cURL de PHP podemos consultar una API de pruebas pública:
<?php
$ch = curl_init('https://jsonplaceholder.typicode.com/posts/1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$respuesta = curl_exec($ch);
$codigo = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($codigo === 200) {
$datos = json_decode($respuesta, true);
echo htmlspecialchars($datos['title']);
} else {
echo 'La API respondió con el código ' . $codigo;
}
Enviar datos con POST
$ch = curl_init('https://jsonplaceholder.typicode.com/posts');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode(['title' => 'Hola', 'body' => 'Prueba', 'userId' => 1]),
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
Crear un endpoint propio
Un archivo PHP puede responder JSON y convertirse en una API sencilla:
<?php
header('Content-Type: application/json; charset=utf-8');
$pdo = new PDO('mysql:host=localhost;dbname=tienda;charset=utf8mb4', 'usuario', 'clave');
$id = isset($_GET['id']) ? (int) $_GET['id'] : 0;
$consulta = $pdo->prepare('SELECT id, nombre, precio FROM productos WHERE id = ? AND activo = 1');
$consulta->execute([$id]);
$producto = $consulta->fetch(PDO::FETCH_ASSOC);
if (!$producto) {
http_response_code(404);
echo json_encode(['error' => 'Producto no encontrado']);
exit;
}
echo json_encode($producto);
Autenticación
La mayoría de las APIs reales exigen una clave (API key) o un token que se envía en las cabeceras. Nunca ponga estas claves en el código JavaScript del navegador ni las suba a un repositorio público; guárdelas en el servidor, en variables de entorno o archivos de configuración protegidos.
Buenas prácticas
- Defina tiempos de espera para que su sitio no se bloquee si la API no responde.
- Maneje los errores y muestre mensajes amables al usuario.
- Guarde en caché las respuestas que no cambian a menudo.
- Respete los límites de uso de cada API.
En Creasotol integramos APIs de pagos, envíos, facturación y más en los sitios de nuestros clientes. Cuéntenos qué necesita conectar.