Cómo usar WordPress como API para tus proyectossss

WordPress no es solo una plataforma para crear sitios web y blogs: también puede funcionar como un backend potente que expone datos mediante su API REST. Esto te permite usar WordPress como un Headless CMS, consumiendo el contenido desde aplicaciones web, móviles o cualquier otro sistema externo.

En este artículo veremos qué es la API REST de WordPress, cómo activarla, cómo consumir datos y cómo extenderla con endpoints personalizados.


1. ¿Qué es la API REST de WordPress?

Desde la versión 4.7, WordPress incluye de forma nativa una API REST que permite acceder y manipular contenido mediante peticiones HTTP (GET, POST, PUT, DELETE).

La API expone endpoints en formato JSON, por ejemplo:

 
https://tusitio.com/wp-json/wp/v2/posts

Retorna un listado de posts con todos sus metadatos, lo que significa que puedes consumir contenido de WordPress desde cualquier lenguaje o framework: React, Vue, Angular, Flutter, Swift, etc.


2. Activar la API REST en WordPress

La API REST viene habilitada por defecto, pero para usarla:

  • Debes tener WordPress 4.7 o superior.

  • Asegúrate de que los enlaces permanentes (permalinks) estén configurados (Ajustes → Enlaces permanentes).

  • Verifica que no tengas plugins de seguridad que bloqueen /wp-json/.

Para probar si está activa, abre en tu navegador:

 
https://tusitio.com/wp-json/

Si ves un JSON con información del sitio, ¡la API está lista!


3. Endpoints principales de la API de WordPress

La API REST de WordPress sigue una estructura:

 
https://tusitio.com/wp-json/wp/v2/{recurso}

Algunos recursos más usados son:

  • Posts: /wp/v2/posts

  • Páginas: /wp/v2/pages

  • Categorías: /wp/v2/categories

  • Etiquetas: /wp/v2/tags

  • Usuarios: /wp/v2/users

Ejemplo para obtener los últimos 5 posts:

 
GET https://tusitio.com/wp-json/wp/v2/posts?per_page=5

4. Autenticación para operaciones protegidas

Si solo quieres leer contenido público, no necesitas autenticación.
Pero si deseas crear, actualizar o eliminar contenido, debes autenticarte.

Opciones de autenticación:

  • Cookies de autenticación (solo en el mismo dominio).

  • Basic Auth (para pruebas, mediante usuario y contraseña codificados en Base64).

  • JWT (JSON Web Tokens) – más seguro y recomendado para aplicaciones externas.

Ejemplo con Basic Auth en cURL:

 
curl -X POST https://tusitio.com/wp-json/wp/v2/posts \
-u usuario:contraseña \
-H "Content-Type: application/json" \
-d '{"title": "Nuevo post desde la API", "status": "publish"}'

5. Consumir WordPress como Headless CMS

La API REST permite separar el frontend del backend:

  • WordPress administra el contenido.

  • Tu frontend (React, Vue, Next.js, etc.) consume el contenido vía API.

  • Esto mejora la velocidad, escalabilidad y flexibilidad del proyecto.

Ejemplo en JavaScript usando fetch:

 
fetch("https://tusitio.com/wp-json/wp/v2/posts")
.then(res => res.json())
.then(data => {
data.forEach(post => {
console.log(post.title.rendered);
});
});

6. Crear endpoints personalizados

A veces necesitas datos que la API nativa no ofrece.
Puedes registrar tus propios endpoints con register_rest_route() en functions.php o en un plugin.

Ejemplo:

 
add_action('rest_api_init', function () {
register_rest_route('miapi/v1', '/mensaje', array(
'methods' => 'GET',
'callback' => function () {
return array('mensaje' => 'Hola desde mi API personalizada');
}
));
});

Ahora podrás acceder a:

 
https://tusitio.com/wp-json/miapi/v1/mensaje

7. Buenas prácticas

  • Usa caché para reducir llamadas repetitivas.

  • Filtra y sanitiza los datos recibidos.

  • Usa HTTPS para seguridad.

  • Documenta los endpoints personalizados.

  • Limita resultados con parámetros (per_page, page) para mejorar rendimiento.


Conclusión

Usar WordPress como API te da lo mejor de dos mundos: la facilidad de gestión de contenidos de WordPress y la flexibilidad de un backend headless. Ya sea para una web moderna con React, una app móvil en Flutter o un dashboard personalizado, la API REST de WordPress es una herramienta potente y lista para usar.

Comentarios

Una respuesta a «Cómo usar WordPress como API para tus proyectossss»

  1. Avatar de A WordPress Commenter

    Hi, this is a comment.
    To get started with moderating, editing, and deleting comments, please visit the Comments screen in the dashboard.
    Commenter avatars come from Gravatar.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *