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.

Responder a A WordPress Commenter Cancelar la respuesta

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