buttonwar8

La API REST de WP está en proceso de cambio de WP. Es posible que no lo haya apreciado, puesto que gran parte de ella está bajo el capó, pero las implicaciones de API REST marcan gran diferencia para el futuro de Wordpress, tanto en términos de su base de código como de sus usos.

Si no ha trabajado con API REST de empresas de marketing digital en madrid , puede que se pregunte qué es. Así que vamos a iniciar mirando lo que es API de REST.

¿Qué es API de REST de Wordpress?

API REST de WP es una interfaz quepueden emplear para acceder a WP desde fuera de la propia instalación de WP. Se accede a él usando JavaScript, lo que quiere decir que se puede usar para crear sitios y aplicaciones interactivas.

REST significa Representational State Transfer y API significa Application Programming Interfaz. Echemos un vistazo a lo que significa cada uno de ellos.

¿Qué es una Interfaz de Programación de Aplicaciones (API)?

Una Interfaz de Programación de Aplicaciones, o bien API, secomo:

«Una interfaz o protocolo de comunicación entre un usuario y un servidor para simplificar la construcción de software del lado del cliente del servicio.»

Si no está familiarizado con las API, es posible que eso no le ayude mucho. En pocas palabras, una API es un conjunto de código que deja a un sistema interactuar (o bien «interfaz») con otro. Si alguna vez ha, ha empleado API de Google Maps, que deja que su lugar de WordPress interactúe con Google Maps.

Estos sistemas no necesitan estar absolutamente separados. WP ya tiene múltiples, para cosas como, configuraciones y. Estos pueden ser usados por los desarrolladores de plugins y temas para interaccionar con el núcleo de Wordpress y hacer que las cosas sucedan (como crear atajos y añadir pantallas de configuración al administrador de Wordpress).

La diferencia con la API de REST es que deja que los sistemas fuera de la propia instalación de WordPress interactúen con WordPress, que es donde entra en juego la parte de REST.

¿Qué es la trasferencia estatal de representación (REST)?

Representational State Transfer, o REST, da estándares que los sistemas web pueden utilizar para interactuar entre sí. Sin REST, dos sistemas no podrían entenderse entre sí y, por ende, enviar datos de un lado a otro.

Para que una aplicación sea, debe cumplir con 5 principios:

1. Interfaz uniforme. Las URLs empleadas para acceder a los recursos del sistema tienen que ser uniformes, consistentes y alcanzables a través de un enfoque común como GET (se explicará más tarde).
2. Cliente-servidor. Las aplicaciones usuario y las aplicaciones de servidor han de estar separadas, de forma que puedan desarrollarse independientemente unas de otras. Si la tecnología del lado del servidor (o sea, Wordpress) cambia, la aplicación del lado del servidor (una aplicación, por ejemplo) debe poder acceder a ella a través del mismo método sencillo.
3. Stateless (Protocolo sin estado). El servidor no cambia de estado cuando se realiza una nueva solicitud usando la API. No almacena las peticiones que se han hecho.
4. Cachéable. Todos los recursos deben poder guardarse en caché para prosperar la velocidad y la conformidad con los estándares web. Else puede implementar en el lado del servidor o bien del cliente del servicio.
5. Sistema de capas. Un sistema RESTful le deja usar múltiples capas para acceder a él, guardando los datos en servidores intermedios si es necesario. El servidor no puede decir si el usuario final está directamente conectado a él.

Todas estas restricciones se refieren a páginas web y aplicaciones y rigen la manera en que una aplicación puede interaccionar con la API.

¿Qué significa esto para Wordpress?

La combinación de REST y API significa que API REST de WP es un conjunto de código diseñado para hacer posible que otros sistemas interactúen con Wordpress y que está construido de una forma que asegura que estos sistemas se comprendan entre sí.

Esto quiere decir que un sitio de terceros o una aplicación móvil, por ejemplo, puede acceder a la, conseguir datos de ella y añadir datos a exactamente la misma.

Sin embargo, hay una serie de implicaciones y usos para ello.

Entendiendo API REST de WordPress

API REST de Wordpress fue desarrollada como respuesta a los cambios en la forma en que se desarrollan los sitios y las aplicaciones y a la necesidad de abrir WordPress más extensamente.

Fondo de API REST de WordPress

API REST de WordPresscomo una parte del núcleo en la versión cuarenta y siete en el mes de diciembre de dos mil dieciseis, pero ya estaba disponible como un plugin ya antes de esa fecha.

Está diseñado para aguantar una extensa gama de aplicaciones construidas sobre WordPress y para convertir Wordpress de una una plataforma de aplicaciones.

Es usado extensamente por, cuya interfaz basada en JavaScript emplea API REST para interactuar con la base de datos de Wordpress. También es utilizado por la, que se convirtió en parte del núcleo en dos mil diecinueve.

API REST amplía la gama de aplicaciones para las que se puede usar WordPress. Al tiempo que un sistema de gestión de contenidos destaca en la ejecución de un sitio complejo, una plataforma de aplicaciones también se puede utilizar para impulsar aplicaciones de una sola página basadas en web o SPAs (si alguna vez ha usado, ha empleado uno de ellos).

En estos, el contenido se actualiza cuando el usuario toma acción, en lugar de cargar nuevas páginas. Debido a que emplea JavaScript (un lenguaje del lado del usuario) en sitio de(un lenguaje del lado del servidor), puede hacer que las cosas sucedan en el navegador del usuario sin tener que enviar constantemente solicitudes al servidor.

Implicaciones para los usuarios y desarrolladores de WordPress

Si usted es un usuario y/o desarrollador que trabaja con WP, API REST tiene una serie de implicaciones.

Para los usuarios, estos incluyen:

• Cambios en la interfaz, incluyendo el editor de Gutenberg.
• Cambios y mejoras en la aplicación WP para móviles.
• Las pantallas de administración de WP auto-organizadas se semejan más a las pantallas decon el correr del tiempo.

Para los desarrolladores, hay implicaciones y posibilidades más amplias:

• La capacidad de crear SPAs utilizando API REST, atrayendo datos de WP pero con un aspecto muy diferente al de WP.
• La capacidad de integrar WordPress con otras tecnologías y sistemas frontend.
• La capacidad de desarrollar con Wordpress si es un desarrollador de frontend que no escribe PHP.
• Para los desarrolladores de PHP, una necesidad creciente de ampliar sus habilidades para incluir JavaScript.
• Cambios específicos como la necesidad de edificar bloques Gutenberg en lugar de meta boxes en las pantallas de edición de páginas y postproducción.

Con el tiempo, API REST de WP significará que la mayor parte del núcleo de WP se escribirá en JavaScript y no en PHP. Si es un desarrollador de Wordpress, esto quiere decir que necesitará aprender JavaScript.

¿Cómo acceder a API REST de WordPress?

¿Cómo se accede a API REST de WordPress?

Para acceder a WP-API REST, deberá acceder a su lugar a través de la línea de comandos. Con Wordpress, esto se llama. Usted no hace nada de esto a través de sus pantallas de administración o accediendo de manera directa al código de su lugar.

Echemos una ojeada a cómo empezar.

Acceso a WP-REST mediante WP-CLI

WP-CLI es la interfaz de línea de comandos de WordPress. Le deja acceder y trabajar con Wordpress a través de la interfaz de línea de comandos (CLI) de su computador. WP-CLI está preinstalado con todos los planes de alojamiento de Kinsta.

Para acceder a la CLI, abra Terminal en un Mac o bien en Linux, o Símbolo del sistema en Windows.

Terminal on Mac

Para acceder a un lugar recóndito, necesitapara acceder a él a través de WP-CLI (¿No puedes conectarte por SSH? Aprende a).

Para acceder a un, es suficiente con utilizar la estructura de directorios correcta desde la línea de comandos. Es una buena idea probar con API REST en un lugar de pruebas local antes de probarla en un sitio en vivo.

Necesitará acceder específicamente a API REST de su sitio, de esta manera:

A continuación, puede añadir elementos para acceder a determinados tipos de datos, que analizaremos con más detalle en breve. Estos elementos se llaman puntos finales.

Autenticación

Una vez que haya accedido a su sitio, es posible que deba pasar por un proceso de autenticación. Ciertos endpoints son públicos y no requieren autenticación, mientras que otros sí.

No estáaquí: API REST hace las cosas de forma un poco diferente.

Para poder autenticar su lugar a través de WP-CLI, necesitará instalar un complemento de autenticación. Para las instalaciones de desarrollo, el pluginhace el trabajo y es fácil de emplear.

Sin embargo, para sitios en vivo, debería utilizar una forma más robusta de autenticación como el plugin, que utiliza JSON Web Token y es más seguro.

A continuación, puede utilizar la línea de comandos para acceder a los datos y también incluir la autenticación.

El siguiente ejemplo utiliza
curlpara probar la conexión con WordPress. Se emitirá una lista de bocetos de puestos.

Los borradores de mensajes no son información pública, por lo que precisa autenticación para acceder a ellos. Pero si está buscando datos que son públicos, no necesita autenticación. Así que para recuperar una lista de mensajes que han sido publicados, puede utilizar:

Esto obtendría todos los mensajes publicados pues son públicos.

Descripción general de los comandos de API REST de WordPress

Una vez que haya accedido a su lugar y sepa cómo utilizar la autenticación (y, de hecho, si es necesario), tendrá que usar uno de una serie de comandos para interaccionar con su sitio.

Los comandos que necesitará usar son:

• 
  GETrecupera un recurso como un blog post u otros datos.
• 
  POSTañade un recurso al servidor, como un mensaje, un archivo adjunto u otro recurso.
• 
  PUTse puede utilizar para editar o actualizar un recurso que está en el servidor.
• 
  DELETEelimina un recurso del servidor. Utilícelo de manera cuidadosa!

Echemos un vistazo a cada uno de ellos de ellos por separado.

GET

El comando GET

El commando
GETes probablemente el más utilizado: recobra datos. El próximo ejemplo le mostrará una lista de todas las páginas publicadas en su sitio:

Tenga en cuenta que no he incluido la senda completa a su sitio en la línea de arriba, en tanto que ya ha accedido a ella utilizando WP-CLI.

Una vez recuperados esos datos, puede usarlos para informar al siguiente paso. Puede borrar uno de esos mensajes, editarlo o actualizarlo. Podría simplemente enviar mensajes a su aplicación web.

Digamos que quiere ir a buscar el último post. Usaría esto:

Hay una serie de razonamientos que puede usar cuando trabaja con mensajes. Consulte elpara obtener más información.

POST

El comando POST

Utilice
POSTpara añadir nuevos datos o recursos a su lugar.

Así que, por ejemplo, si desea crear un mensaje, empezará utilizando un comando
POST:

Esto crearía un nuevo borrador vacío.

A continuación, puede actualizar el mensaje usando un comando
PUTpara editarlo.

Con un comando
POST, también puede añadir otros recursos además de los puestos, incluyendo adjuntos y otros géneros de puestos.

Para añadir una página a su sitio, puede emplear algo como esto:

Esto crearía una página vacía de exactamente la misma forma que crearía una entrada vacía.

PUT

El commando PUT

El comando
PUTle deja editar un recurso existente, incluyendo los mensajes.

Supongamos que tiene múltiples bocetos en su sitio. Desea revisarlas y actualizar una para que se publique.

Podrías comenzar por obtener una lista de todos y cada uno de los mensajes de borrador:

El sistema le dará una lista de todos y cada uno de los borradores actuales. Puede modificar el status de uno de ellos usando su ID:

Esto accede a ese mensaje y le deja editarlo. A continuación, puede alterar su status utilizando el argumento de status:

O bien, puede agregar contenido al mensaje y publicarlo:

El servidor devolverá un estado de
200 - OKque indica que la petición PUT ha editado correctamente el mensaje.

DELETE

El comando DELETE

El comando
DELETEhace lo que esperaría: borra un recurso. Por defecto, si lo emplea para borrar un mensaje, lo pondrá en la papelera en vez de borrarlo permanentemente.

¿Cansado de experimentar inconvenientes con su sitio de WordPress? Obtenga el mejor y más rápido soporte de alojamiento con Kinsta!

Así que si quisiese desplazar el mensaje que termina de crear a la papelera, usarías esto:

Sin embargo, si quisiera pasar por alto la papelera y suprimirla permanentemente, usaría el argumento
force:

Esto suprime de manera permanente el mensaje sin opción de deshacerlo, con lo que se debe usar con precaución.

¿Cuándo no utilizar API REST de WordPress?

API REST de Wordpress no siempre y en toda circunstancia será el enfoque adecuado para desarrollar un sitio o bien una aplicación. He aquí algunas consideraciones que debe tener en cuenta antes de emplearlo para el desarrollo:

Compatibilidad

Si su aplicación se marcha a utilizar en dispositivos que no ejecutan JavaScript o bien por usuarios que seguramente la tengan desactivada, no se ejecutará si está usando API REST.

Un lugar WordPress codificado en PHP producirá HTML para que no padezca este inconveniente. Los dispositivos que no emplean JavaScript son cada vez más raros, mas si está desarrollando específicamente para ellos, API REST no funcionará.

Del mismo modo, si es probable que sus usuarios desactiven JavaScript, entonces trabajar con API REST causará inconvenientes. Ciertos usuarios desactivan JavaScript en sus navegadores por razones de accesibilidad o seguridad.

Accesibilidad

Los sitios o bien aplicaciones desarrollados con JavaScript no siempre y en todo momento son tan accesibles como los que salen en HTML.

Esto se debe en gran medida a la forma en que se utiliza JavaScript para dar contenido dinámico que puede no marchar bien con los lectores de pantalla y puede crear problemas a las personas con deficiencias visuales o bien epilepsia fotosensible.

Usar API REST para acceder a su sitio WordPress y a los datos de salida de una manera que esté diseñada para ser alcanzable significa que puede superar estos inconvenientes, mas merece la pena revisar la accesibilidad de su lugar mientras lo está desarrollando.

SEO

Las aplicaciones de una sola página, que se actualizan con cierta frecuencia, en ocasiones pueden ocasionar. Esto se debe a que el contenido que no se entrega cuando se imprime por vez primera la página puede no ser indizado por los motores de búsqueda.

están poniendo al día con el hecho de que muchos sitios web ahora tienen SPA y los están indexando apropiadamente. Pero vale la pena hacer unacompleta de cualquier lugar que desarrolle utilizando API REST.

¿Cómo desactivar la API de REST de Wordpress?

Si no desea que las aplicaciones puedan acceder a los datos de su sitio a través de API REST, puede desactivarla. Recuerde que los datos públicos pueden ser alcanzables para cualquier persona, no sólo para .

Para ello, puede instalar el plugin. Esto desactiva la API REST para cualquiera que no haya empezado sesión en su sitio.

Deshabilitar WP REST API plugin

Alternativamente, puede agregar algún código al fichero de funciones de su tema o escribir su propio plugin. Es mejor escribir un plugin en tanto que no es una funcionalidad específica del tema.

En su plugin, agregue sólo 2 líneas:

Esto deshabilitará completamente API REST para su sitio. Es posible que tenga efectos secundarios para sus pantallas de administración, así que asegúrese de que todo funciona adecuadamente en el momento en que lo haya añadido.

Aplicaciones del planeta real utilizando API REST de WordPress

La API REST presenta ciertas posibilidades interesantes para el futuro de WP. Aquí hay algunos ejemplos de aplicaciones y sitios que usan API REST de WordPress para crear SPAs o bien para enlazar WP con otros sitios y tecnologías.

WordPress.com

WordPress.com

Las pantallas de administración de WordPress.com están construidas totalmente utilizando API REST para proporcionar un SPA con el que los usuarios interactúan para dirigir su lugar.

Esto hace que la comunicación entre la interfaz y el servidor sea dinámica y resulta en una interfaz fácil de utilizar que Wordpress.org probablemente imitará con el tiempo.

El Editor de Bloques (Gutenberg)

El editor de Gutenberg

También en las pantallas de administración de Wordpress, pero esta vez también en WordPress autohospedado, el editor de bloques de Gutenberg emplea API REST para comunicarse con su base de datos y crear bloques.

Para que los modelos de mensajes funcionen con el editor Gutenberg, deben tener habilitada API REST. Lo que significa que si está registrando uny usa Gutenberg, tendrá que añadir la siguiente línea para habilitar el editor de bloques para ese tipo de mensaje:

Event Espresso

Event Espresso

es un plugin de WordPress que permite a los usuarios organizar y publicitar acontecimientos. Utiliza API REST para que los usuarios puedan acceder a los datos desde fuera de WordPress. Esto quiere decir que puede crear aplicaciones móviles o bien SPAs para gestionar sus eventos.

UsTwo

UsTwo

es una agencia digital cuyo lugar fue construido utilizando API REST como una aplicación de una sola página. Esto combina un front-end construido usando React con un backend alimentado por WP (lectura sugerida:).

El contenido de su página única es modular, con una estructura diferente a la de una página estándar de WordPress. A fin de que esto funcione, emplean un plugin de creación de páginas personalizado que deja a su equipo añadir contenido modular al lugar.

USA Today

USA Today

El sitio web defue reconstruido usando la integración de API REST WordPress con los sistemas y módulos existentes en el sitio.

API REST permitió que el contenido del sitio fuera enviado a otros puntos de venta comoy Apple News, utilizando JSON. También escribieron un juego social en línea para su sección de deportes, construido usando JavaScript.

La API REST de WP abre muchas oportunidades en el ecosistema de WP. Aprenda a sacarle el máximo provecho con esta guía en profundidad! 🔀⚙️ Haga click para Tweet

Resumen

API REST de WP presenta ciertos retos interesantes, mas también ocasiones interesantes tanto para los usuarios de Wordpress como para los desarrolladores. Es ely probablemente cambie radicalmente la forma en que desarrollamos con WP y la forma en que lo usamos.

¿Cuál es su opinión sobre API REST? ¿Lo ha usado para ciertos de sus proyectos? Cuéntanoslo en la sección de comentarios de abajo!

Si le ha gustado este artículo, entonces le encantará la plataforma de Kinsta Wordpress alojamiento web. Acelere su lugar y reciba soporte 24/7 de nuestro equipo de WordPress veterano. Nuestra infraestructura potenciada por Google Cloud se centra en escalamiento automático, rendimiento y seguridad. ¡Déjenos mostrarle la diferencia con Kinsta!