¿Te gustaría recuperar tus entradas desde una aplicación móvil?, ¿o tal vez integrar el contenido de tu sitio con una aplicación de escritorio?, las posibilidades son infinitas a través del uso de la REST API de WordPress.
1- Generalidades
Además de nuestro sitio web, existen diversas aplicaciones con las que interactuamos; los Servicios Web nos permiten integrar aplicaciones externas de manera sencilla. En WordPress utilizaremos REST API como un Servicio Web para la comunicación entre aplicaciones.
Conceptos importantes:
- API (Application Programming Interface) es una interfaz de programación que un software ofrece a otro, a través de rutinas, funciones y métodos.
- REST (Representational State Transfer) es una arquitectura de software para sistemas hipermedia distribuídos. En la actualidad se usa para describir cualquier interfaz entre sistemas que utilice directamente HTTP para obtener datos o indicar la ejecución de operaciones sobre los datos, en cualquier formato (XML, JSON, etc).
- Recursos: Son los bloques principales de la arquitectura REST, cuando hablamos de WordPress estos recursos son: entradas, páginas, comentarios, usuarios, etc
- URIs (Uniform Resource Identifier): Es la dirección para identificar a un recurso.
- HTTP Verbs: Una REST API permite realizar diversas operaciones como leer, crear, actualizar y borrar recursos, para esto usa los HTTP Verbs como sigue:
- GET: Usado para leer o devolver un recurso.
- POST: Usado para crear un nuevo recurso.
- PUT: Usado para actualizar un recurso.
- DELETE: Usado para borrar un recurso.
- HEAD: Usado para verificar la existencia de un recurso.
- OPTIONS: Usado para devolver información que soporta un recurso.
2- REST API en WordPress
La REST API WordPress convierte a tu sitio en una poderosa herramienta de administración y publicación de contenido fácil de usar por otras aplicaciones.
En futuras versiones de WordPress esta funcionalidad vendrá totalmente incluida, sin embargo a la fecha tenemos que instalar el plugin WP REST API (V2).
3- Haciendo consultas a la REST API
Una vez tenemos instalado el plugin podemos realizar diferentes consultas directamente en la barra de navegación o usar un complemento de navegador como Postman o REST easy.
Debemos agregar /wp-json/wp/v2/ a nuestra url de petición, en la siguiente imagen se ha usado Postman para hacer una petición Get de todos las entradas del sitio.
Esta petición nos devolverá el contenido de nuestras entradas en formato Json.
A continuación veremos algunas peticiones más comunes:
Listar todas las entradas usando GET
http://midominio.com/wp-json/wp/v2/posts/
Listar una entrada específica xxx usando GET
http://midominio.com/wp-json/wp/v2/posts/xxx
Listar las entradas de la categoría xxx usando GET
http://midominio.com/wp-json/wp/v2/posts?filter[cat]=xxx
4- Autenticación en la REST API
La autenticación nos permite realizar tareas de creación, actualización y eliminación de datos. WP REST API permite tres tipos de autenticación:
A continuación usaremos código PHP para conectarse a un sitio Web que tenga habilitado la REST API y realizaremos tareas de creación, actualización y eliminación de entradas.
Para desarrollar nuestro ejemplo usaremos la autenticación base, instalaremos el plugin Basic Auth. Tener en cuenta que este tipo de autenticación no debería ser usado en entornos de producción.
5- Creando una nueva entrada
El siguiente código PHP sirve para conectarse a nuestro sitio WordPress y crear una nueva entrada
Lo que hace este código:
- Defino la url de mi sitio REST API en la variable $host
- La variable $data_string tendrá los datos del nuevo post en formato json
- Defino la variable $headers, tener en cuenta que aquí pasaremos los datos de autenticación.
- Uso CURL
- Paso las cabeceras
- Puesto que es una creación usaré POST
- Paso los datos
- Defino para retornar un resultado
6- Actualizando una entrada
Para realizar una modificación lo único que tenemos que cambiar en el código anterior es la url de la variable $host y los datos a modificar en la variable $data.
La url a usar será del tipo:
$host = ‘http://encurso.app/wordpress461/wp-json/wp/v2/posts/123’;
En donde 123 es el ID del post a modificar, el código completo se puede ver a continuación:
7- Borrando una entrada
Para realizar una eliminación la url de la variable $host es similar a una actualización, la diferencia es que en este caso no necesitamos pasar la variable $data.
En el código anterior :
- Vemos que la url tiene el valor 123 que es el ID del post a eliminar.
- Usamos DELETE para indicar a la REST API que se trata de una eliminación.
8- Conclusión
En los tres últimos puntos hemos visto cómo realizar operaciones sobre las entradas de WordPress usando código PHP, sin embargo es posible usar cualquier otro lenguaje de programación para realizar estas operaciones, la REST API de WordPress se encargará de gestionar las operaciones enviadas.
¿Aún con dudas? En el siguiente video se explica en detalle los puntos anteriores.
Artículos Relacionados
(3 votos, promedio: 4,67 de 5)
Cargando…
He buscado información sobre este tema hasta cansarme… y aparece tu sitio, ¡gracias!
Además del conocimiento que atesoras, la didáctica, el ritmo de los tutoriales es excelente.
Te agradezco muchísimo el que expongas información que no se ve en ningún lado en español, y aunque me voy defendiendo con el inglés, en mi idioma me resulta más rápido cualquier aprendizaje.
Un saludo,
Hola
quisiera saber como hacer para filtrar un id de página, he intentado con los filters que se utilizan para los post, pero no funciona para las páginas.
Gracias, saludos.