Una introducción a la API REST de WordPress

Publicado: 2017-01-13

El lanzamiento de WordPress 4.7 generó mucho entusiasmo en la comunidad, y por una buena razón. Además de las muchas mejoras y características introducidas, el verdadero ladrón de espectáculos fue el anuncio de integración del núcleo de la API REST. Como mencionamos en publicaciones anteriores, esto transforma efectivamente a WordPress de una plataforma de blogs a un Sistema de gestión de contenido (CMS). Pero, ¿cómo se llevará a cabo esta transformación? ¿Y cuáles serán los beneficios para los usuarios?

En este artículo, primero le presentaremos algunos de los conceptos fundamentales y luego le mostraremos cómo puede comenzar a jugar con la API y su sitio web.

Todos los sitios web de nuestros clientes ya se han actualizado a WordPress 4.7.1. ¡Vamos a empezar!

¿Qué es una API?

API significa Interfaz de programación de aplicaciones. Es un conjunto de estructuras documentadas que se ajustan a un funcionamiento estándar como bloques LEGO para desarrolladores de software. Estas estructuras pueden ser estructuras de datos, llamadas a funciones, componentes de nivel superior, prácticamente cualquier cosa. Los desarrolladores de software utilizan las API para crear software más complejo a partir de ellas. A menudo se utilizan como un método de comunicación entre varios componentes de software, ya sea que estén alojados localmente (piense en bibliotecas de software) o de forma remota en Internet, como es el caso de las API REST.

Hay API para muchos niveles diferentes de software, desde el sistema operativo hasta la web.

¿Qué es una API REST?

REST significa REpresentational State Transfer y permite la misma interoperabilidad y comunicación de componentes, pero en un nivel superior: la Web. Con REST, puede tener diversos software basados en web escritos en Python, Java o PHP, comunicándose e intercambiando datos entre sí, incluso si están alojados en diferentes sistemas. Dado que cada sistema sabe cómo "hablar" REST, ¡puede hablar con todos los que lo hacen!

REST utiliza el protocolo HTTP como transporte de comunicaciones y las solicitudes HTTP estándar para implementar sus operaciones básicas. Estas operaciones se llaman verbos. Los más utilizados son: PUT, GET, PATCH, DELETE. Estos verbos actúan sobre las cosas que REST llama Recursos. Los implementa el desarrollador de software e implementan de manera efectiva las cuatro operaciones informáticas fundamentales que funcionan en el almacenamiento: Crear, Leer, Actualizar, Eliminar ( CRUD ).

Para la representación y el intercambio de datos, REST utiliza una especificación de datos ligera llamada JSON ( notación de objetos Javascript ). La estructura de JSON es muy simple. Su simplicidad y facilidad de uso, en comparación con las especificaciones de mil páginas de XML y otros, le valieron la adopción inmediata por parte de los desarrolladores, convirtiéndolo en el estándar de intercambio de datos de facto de la Web.

¿Cómo lo implementa WordPress?

Entonces tenemos el concepto de verbos (Crear, Leer, Actualizar, Eliminar) actuando sobre Recursos. WordPress define como recurso REST prácticamente todos los elementos discretos de información que existen en la plataforma. Desde los usuarios de un sitio hasta configuraciones, publicaciones, taxonomías de publicaciones, notificaciones, medios, estadísticas y todo lo demás. Esto incluye las operaciones que se pueden definir para estos recursos. Por ejemplo, las operaciones definidas para los comentarios son las siguientes:

Obtener una lista de comentarios recientes.
Obtener una lista de comentarios recientes en una publicación.
Obtenga un solo comentario.
Editar un comentario.
Crear un comentario en una publicación.
Crear un comentario como respuesta a otro comentario.
Eliminar un comentario.
Obtenga los "me gusta" para un comentario.
Como un comentario.
Elimina tu Me gusta de un comentario.
Obtenga su estado de Me gusta para un comentario.

Eche un vistazo a la página de documentación oficial de la API para WordPress a su gusto, para tener una idea de la amplitud y profundidad de la API y compruebe lo que puede hacer. ¡Las posibilidades son tantas!

WordPress, por lo tanto, se convierte en una plataforma de desarrollo y un CMS al tratar cada bit de datos que existe en él como un recurso REST . Los expone a todos bajo una API pública y estandarizada que permite a terceros realizar operaciones CRUD en ellos . De esta forma, WordPress se abre y se vuelve interoperable con el resto del mundo del software, ya sea Java, Python o Ruby; y prácticamente con todos los lenguajes o sistemas que saben cómo comunicarse usando REST.

Pruébelo usted mismo

Hay varias formas en las que puede comenzar a jugar con la API REST de su sitio web. El más fácil de usar un complemento de prueba REST en su navegador. Hay varios, pero el más popular es Postman (disponible para MacOSX, Windows y Chrome).

Por ejemplo, supongamos que desea recuperar un objeto JSON que contiene todas las publicaciones de nuestro blog. Para hacer esto, primero debe consultar la referencia oficial de REST de WordPress para averiguar la ruta base de esa llamada de solicitud (es /wp/v2/posts ).

Todo lo que tenemos que hacer ahora es lo siguiente:

Seleccione OBTENER en el menú desplegable. Hay muchos verbos REST disponibles como puede ver, pero cubrirlos todos no es el alcance de este artículo.
Agregue la ruta base ( /wp/v2/posts ) a la URL raíz REST de su sitio web (http://www.acme_shop_2.onpressidium.com /wp-json/ ) formando la URL que ve en la pantalla.
Haga clic en el botón Enviar .

Si todo va bien, podrá ver la respuesta JSON de su sitio web en la pestaña Cuerpo debajo. Puede experimentar con diferentes rutas base y verbos consultando la documentación. La API REST de WordPress es algo de lo que nos ocuparemos en futuras publicaciones, en las que haremos un amplio uso de ella, en artículos más orientados a desarrolladores.

¡El futuro de WordPress es brillante!

A lo largo de los años, WordPress ha evolucionado mucho y ha dado nuevas posibilidades a los usuarios. Para todos, desde bloggers individuales, periodistas, editores hasta dueños de negocios y ahora hasta desarrolladores de software de otras comunidades de código abierto. WordPress sigue empoderando a sus usuarios. Continúa siendo un ejemplo de lo que las personas pueden lograr cuando están impulsadas por la misma pasión, pero provienen de diversos orígenes. Su integración de API REST al núcleo de WordPress, no solo abre un nuevo mundo de posibilidades, sino que también crea un nuevo mundo de complejidad . De esto se trata realmente nuestra solución de alojamiento administrado de WordPress, esta es nuestra contribución a la comunidad. Se trata de habilitarlo a usted ya su empresa diaria . Se trata de luchar contra toda esa complejidad, mantener todo funcionando y tarareando y estar allí, cuando las cosas, inevitablemente, se rompan.